droidgap [command] [parameters]+ ./bin/create [path package activity] + ./bin/debug [path] + ./bin/emulate + ./bin/log -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 --------------------------------------------- @@ -66,40 +34,13 @@ Importing a PhoneGap/Android app into Eclipse 6. 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 - -or - - droidgap run - -Converting a W3C Widget into a an APK ---- - -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 +Common Commandline Tools +=== List devices attached --- adb devices - List of devices attached - 0123456789012 device Install APK onto device --- diff --git a/bin/android-sdk-path.bat b/bin/android-sdk-path.bat deleted file mode 100755 index 0abaf6eb..00000000 --- a/bin/android-sdk-path.bat +++ /dev/null @@ -1,2 +0,0 @@ -@ECHO OFF -echo %~dp$PATH:1 \ No newline at end of file diff --git a/bin/create b/bin/create new file mode 100755 index 00000000..063497a1 --- /dev/null +++ b/bin/create @@ -0,0 +1,50 @@ +#! /bin/sh +# +# create a phonegap/android project +# +# USAGE +# ./create [path package activity] +# +PROJECT_PATH=${1:-"./example"} +PACKAGE=${2:-"com.phonegap.example"} +ACTIVITY=${3:-"PhoneGapExample"} +ACTIVITY_PATH=./Example/src/com/phonegap/example/$ACTIVITY.java +TARGET=$(android list targets | grep 'id: ' | sed 's/id: \([0-9]\).*/\1/g' | tail -1) +VERSION=$(cat ./VERSION) + +# clobber any existing example +if [ $# -eq 0 ] +then + rm -rf $PROJECT_PATH +fi + +# compile phonegap.js and phonegap.jar +cd ./framework && ant jar && cd ../ + +# create the project +android create project --target $TARGET --path $PROJECT_PATH --package $PACKAGE --activity $ACTIVITY + +# copy in www +mkdir -p ./Example/assets && cp -r ./bin/templates/www ./Example/assets/www + +# copy in phonegap.js +cp ./framework/assets/www/phonegap-$VERSION.js ./Example/assets/www/phonegap-$VERSION.js + +# copy in phonegap.jar +mkdir -p ./Example/libs && cp ./framework/phonegap-$VERSION.jar ./Example/libs/phonegap-$VERSION.jar + +# copy in default activity +cat ./bin/templates/Activity.java > $ACTIVITY_PATH + +# interpolate the acivity name and package +find "$ACTIVITY_PATH" | xargs grep '__ACTIVITY__' -sl | xargs -L1 sed -i "" "s/__ACTIVITY__/${ACTIVITY}/g" +find "$ACTIVITY_PATH" | xargs grep '__ID__' -sl | xargs -L1 sed -i "" "s/__ID__/${PACKAGE}/g" + +# copy in uses-permission elements +sed '$d' < $PROJECT_PATH/AndroidManifest.xml > tmpFile ; mv tmpFile $PROJECT_PATH/AndroidManifest.xml +cat ./bin/templates/uses-permission-elements >> $PROJECT_PATH/AndroidManifest.xml +echo '' >> $PROJECT_PATH/AndroidManifest.xml + +# copy in plugins.xml +mkdir -p $PROJECT_PATH/res/xml +cp ./bin/templates/plugins.xml $PROJECT_PATH/res/xml/plugins.xml diff --git a/bin/debug b/bin/debug new file mode 100755 index 00000000..55bb656a --- /dev/null +++ b/bin/debug @@ -0,0 +1,3 @@ +#! /bin/sh + +ant debug install diff --git a/bin/droidgap b/bin/droidgap deleted file mode 100755 index bf93568e..00000000 --- a/bin/droidgap +++ /dev/null @@ -1,173 +0,0 @@ -#!/usr/bin/env ruby -ROOT = File.expand_path(File.dirname(__FILE__).gsub(/bin$/,'')) -require 'fileutils' -require File.join(ROOT, "lib", "generate.rb") -require File.join(ROOT, "lib", "classic.rb") -require File.join(ROOT, "lib", "create.rb") -require File.join(ROOT, "lib", "run.rb") -require File.join(ROOT, "lib", "update.rb") -require File.join(ROOT, "lib", "test.rb") - -# ---------------------------------------------------------- # -# # -# command line interface # -# # -# ---------------------------------------------------------- # - -# droidgap gen [app name] -Generate.new(ARGV[1]) if ARGV.first == 'gen' - -# droidgap classic (for windows users mostly) -Classic.new(ARGV[1..-1]) if ARGV.first == 'classic' - -# droidgap create [path to phonegap project] -Create.new(ARGV[1]) if ARGV.first == 'create' - -# droidgap run [optional directory] -Run.new if ARGV.first == 'run' - -# droidgap update [params] -Update.new if ARGV.first == 'update' - -# droidgap log -if ARGV.first == 'log' - $stdout.sync = true - IO.popen('adb logcat') do |f| - until f.eof? - puts f.gets - end - end -end - -# droidgap test -Test.new if ARGV.first == 'test' - -# TODO implement these! -puts "droidgap ship not implemented" if ARGV.first == 'ship' - -if ARGV.first.nil? || ARGV.first == 'help' - help = <<-EOF - - DroidGap: PhoneGap/Android Dev Script - ------------------------------------- - - Useful utilities for devlopers building mobile apps using PhoneGap for Android. - - Usage: - - droidgap
Problem' + (isFinite(c.line) ? ' at line ' + - c.line + ' character ' + c.character : '') + - ': ' + c.reason.entityify() + - '
' + - (e && (e.length > 80 ? e.slice(0, 77) + '...' : - e).entityify()) + '
'); - } - } - } - - if (data.implieds) { - s = []; - for (i = 0; i < data.implieds.length; i += 1) { - s[i] = '' + data.implieds[i].name + ' ' +
- data.implieds[i].line + '';
- }
- o.push('Implied global: ' + s.join(', ') + '
'); - } - - if (data.unused) { - s = []; - for (i = 0; i < data.unused.length; i += 1) { - s[i] = '' + data.unused[i].name + ' ' +
- data.unused[i].line + ' ' +
- data.unused[i]['function'] + '';
- }
- o.push('Unused variable: ' + s.join(', ') + '
'); - } - if (data.json) { - o.push('JSON: bad.
'); - } - o.push('CSS.
'); - } else if (data.json && !err) { - o.push('JSON: good.
'); - } else if (data.globals) { - o.push('/*members ';
- l = 10;
- for (i = 0; i < a.length; i += 1) {
- k = a[i];
- n = k.name();
- if (l + n.length > 72) {
- o.push(m + '
');
- m = ' ';
- l = 1;
- }
- l += n.length + 2;
- if (data.member[k] === 1) {
- n = '' + n + '';
- }
- if (i < a.length - 1) {
- n += ', ';
- }
- m += n;
- }
- o.push(m + '
*/');
- }
- o.push('