mirror of https://github.com/apache/cordova-android.git synced 2025-02-25 19:32:54 +08:00

Go to file

macdonst 0c3a8fb9f7 File API: System and Directories http://www.w3.org/TR/file-system-api/ User can retrieve PERSISTENT and TEMPORARY file systems, list their contents, and manipulate files and directories within them. Modify existing FileWriter implementation ----------------------------------------- - Change the way user creates a FileWriter. User must either pass a File object to the FileWriter constructor, or use the FileEntry.createWriter() method. - Drop support for the 'filePath' and 'append' parameters in the FileWriter constructor. The file path is determined from either the File object passed to the FileWriter constructor, or the FileEntry object used to create the FileWriter. To append to a file, use the FileWriter object's seek method: // writer is a FileWriter object // seek to length of file to append writer.seek(writer.length); Replace FileMgr JavaScript APIs not specified in any File API spec ------------------------------------------------------------------ - Remove navigator.fileMgr.createDirectory(dirName) function. To create a directory, use the DirectoryEntry.getDirectory() method, which is part of the File API: Directories and System spec. Set the Flags.create to 'true': // directory is a DirectoryEntry object directory.getDirectory(path, {create:true}, successCB, failCB); - Remove navigator.fileMgr.getRootPaths() function. To retrieve the root file systems, use the window.requestFileSystem() function, which is part of the File API: Directories and System spec. - Remove navigator.fileMgr.getFileProperties(fileName) function. To get the properties of a file, use the FileEntry.file() method, which is part of the File API: Directories and System spec. - Remove navigator.fileMgr.deleteFile(fileName) function. To delete a file, use the Entry.remove() method, which is part of the File API: Directories and System spec. - Remove navigator.fileMgr.deleteDirectory(dirName) function. To delete a directory, use the Entry.remove() (if it is empty), or DirectoryEntry.removeRecursively() methods, which are part of the File API: Directories and System spec. Clean up existing FileManager native code. Move some functionality to file utility class.		2011-03-05 04:26:31 +08:00
bin	Ticket 80: running "droidgap gen example" leads to recursive directory creation. README fix included.	2011-01-31 17:48:56 -08:00
example	Update index.html to Add networking to example	2011-02-28 23:49:14 +08:00
framework	File API: System and Directories	2011-03-05 04:26:31 +08:00
lib	Small patch to build script: ruby needs double quotes to interpolate variables into it properly.	2011-02-16 16:26:01 -08:00
util	Add JavaScript minification using YUICompressor.	2010-11-30 19:00:30 -06:00
.gitignore	tiny fix to droidgap gen for windows	2010-10-08 11:39:56 -07:00
LICENSE	Update license and copyright notices in each source file. PhoneGap is licensed under modified BSD and MIT (2008).	2010-10-18 15:31:16 -05:00
README.md	Ticket 80: running "droidgap gen example" leads to recursive directory creation. README fix included.	2011-01-31 17:48:56 -08:00
VERSION	Fix for build: version needs to be included in .jar and .js generated files.	2011-02-04 11:35:05 -08:00

README.md

PhoneGap/Android

PhoneGap/Android is an Android application library that allows for PhoneGap based projects to be built for the Android Platform. PhoneGap based applications are, at the core, an application written with web technology: HTML, CSS and JavaScript.

Pre Requisites

Java JDK 1.5
Android SDK http://developer.android.com
Apache ANT
Ruby (Optional, see section: DroidGap with JRuby)

Install

On any POSIX machine add PhoneGap/Android to your PATH variable like so:

export PATH=$PATH:~/phonegap-android/bin

On Windows add the phonegap-android/bin to your PATH as normal.

DroidGap: PhoneGap/Android Dev Script

Tools for developers building mobile apps using PhoneGap for Android.

Usage:

droidgap [command] [parameters]

Commands:

	help ...... See this message. Type help [command name] to see specific help topics.
	gen ....... Generate the example PhoneGap application to current directory (or optionally provide an output directory as parameter).
	create .... Creates an Android compatible project from a WWW folder. 
	classic ... Backwards support for droidgap script. Run "droidgap help classic" for more info.
	update .... Copy a fresh phonegap.jar and phonegap.js into a valid PhoneGap/Android project.
	test ...... Gets edge copy of mobile-spec and runs in first device or emulator attached.

Quickstart:

  	$ droidgap gen exampleapp 
  	$ cd exampleapp
	$ ant debug install && adb logcat

DroidGap with JRuby

If you want to use the droidgap command but do not want to install Ruby then you can call it using jruby jar included in the lib folder. All the options are the same and a call looks like this:

java -jar jruby-complete-1.4.0RC1.jar ../bin/droidgap help run

Keep in mind this will be slower due to JVM warmup.

Importing a PhoneGap/Android app into Eclipse

File > New > Project...
Android > Android Project
Create project from existing source (point to the generated app found in tmp/android)
Right click on libs/phonegap.jar and add to build path
Right click on the project root: Run as > Run Configurations
Click on the Target tab and select Manual (this way you can choose the emulator or device to build to)

Common Command Line Tasks

Running Mobile Spec

droidgap test

Compile an APK

Make sure you have a device plugged in (with debugging enabled) or a running emulator. Then:

ant debug install

droidgap run

Given a Widget called FooBar with an index.html file in it. You navigate to its folder and run:

droidgap create
cd ../FooBar_android
ant debug install

List devices attached

adb devices 
List of devices attached 
0123456789012	device

Install APK onto device

apk -s 0123456789012 install phonegap.apk

Logging

Via console.log calls from your apps javascript.

adb logcat

Debugging

Attach it to a process on the device

$ adb jdwp
adb forward tcp:8000 jdwp: jdb -attach localhost:8000