[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15155260#comment-15155260 ] ASF subversion and git services commented on CB-10332: -- Commit 21afd07d1e14ff4b6dc524738ffaa4fc7594de1f in cordova-docs's branch refs/heads/master from riknoll [ https://git-wip-us.apache.org/repos/asf?p=cordova-docs.git;h=21afd07 ] CB-10332: Android guide improvements. This closes #471 Updates the Android Guide to do the following: * Fix markdown, links, and grammar * Update content * Remove content duplicating Android docs * Convert app development docs to single page guide > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15155261#comment-15155261 ] ASF GitHub Bot commented on CB-10332: - Github user asfgit closed the pull request at: https://github.com/apache/cordova-docs/pull/471 > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15155013#comment-15155013 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r53528143 --- Diff: www/docs/en/dev/guide/platforms/android/plugin.md --- @@ -23,24 +23,17 @@ title: Android Plugins # Android Plugins This section provides details for how to implement native plugin code -on the Android platform. Before reading this, see Application Plugins +on the Android platform. Before reading this, see the [Plugin Development Guide][plugin-dev] --- End diff -- Done > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15154666#comment-15154666 ] ASF GitHub Bot commented on CB-10332: - Github user rakatyal commented on the pull request: https://github.com/apache/cordova-docs/pull/471#issuecomment-186362161 :ship: it! > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15152779#comment-15152779 ] ASF GitHub Bot commented on CB-10332: - Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r53357772 --- Diff: www/docs/en/dev/guide/platforms/android/plugin.md --- @@ -23,24 +23,17 @@ title: Android Plugins # Android Plugins This section provides details for how to implement native plugin code -on the Android platform. Before reading this, see Application Plugins +on the Android platform. Before reading this, see the [Plugin Development Guide][plugin-dev] --- End diff -- I am okay with anything as long as it's consistent. 'Android Development Guide' and 'Android Plugin Development Guide' and so on for each platform? > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15151408#comment-15151408 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on the pull request: https://github.com/apache/cordova-docs/pull/471#issuecomment-185457758 Alright, I'll resurrect it and add some stuff about 5.0.0 > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15151402#comment-15151402 ] ASF GitHub Bot commented on CB-10332: - Github user rakatyal commented on the pull request: https://github.com/apache/cordova-docs/pull/471#issuecomment-185456589 We are not deleting it but referencing it from the main guide. > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15151393#comment-15151393 ] ASF GitHub Bot commented on CB-10332: - Github user omefire commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r53248266 --- Diff: www/docs/en/dev/guide/platforms/android/plugin.md --- @@ -23,24 +23,17 @@ title: Android Plugins # Android Plugins This section provides details for how to implement native plugin code -on the Android platform. Before reading this, see Application Plugins +on the Android platform. Before reading this, see the [Plugin Development Guide][plugin-dev] --- End diff -- I think we should rename it. any ideas? @rakatyal > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15151378#comment-15151378 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on the pull request: https://github.com/apache/cordova-docs/pull/471#issuecomment-185451042 @rakatyal I thought we were deleting the upgrading article > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15151373#comment-15151373 ] ASF GitHub Bot commented on CB-10332: - Github user rakatyal commented on the pull request: https://github.com/apache/cordova-docs/pull/471#issuecomment-185450815 Are we adding link to the 'Upgrading' article? > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15151312#comment-15151312 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r53242147 --- Diff: www/docs/en/dev/guide/platforms/android/plugin.md --- @@ -23,24 +23,17 @@ title: Android Plugins # Android Plugins This section provides details for how to implement native plugin code -on the Android platform. Before reading this, see Application Plugins +on the Android platform. Before reading this, see the [Plugin Development Guide][plugin-dev] --- End diff -- Is that our official naming convention? I'm inclined to leave it as is until we combine all the plugin guides into one. > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15151308#comment-15151308 ] ASF GitHub Bot commented on CB-10332: - Github user omefire commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r53241742 --- Diff: www/docs/en/dev/guide/platforms/android/plugin.md --- @@ -23,24 +23,17 @@ title: Android Plugins # Android Plugins This section provides details for how to implement native plugin code -on the Android platform. Before reading this, see Application Plugins +on the Android platform. Before reading this, see the [Plugin Development Guide][plugin-dev] --- End diff -- This section should probably be renamed: 'Android Plugin Development Guide'. > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15149052#comment-15149052 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on the pull request: https://github.com/apache/cordova-docs/pull/471#issuecomment-184817446 Rebased to master and updated to fix the redirects merged in with #494 > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15145201#comment-15145201 ] ASF GitHub Bot commented on CB-10332: - Github user omefire commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r52791195 --- Diff: www/docs/en/dev/guide/platforms/android/index.md --- @@ -30,278 +30,676 @@ platform-centered shell tools or cross-platform Cordova CLI for development. For a comparison of the two development paths, see the [Overview](../../overview/index.html). For details on the CLI, see [The Command-Line Interface](../../cli/index.html). --- End diff -- Link should point to: http://localhost:3000/docs/en/dev/guide/overview/index.html#development-paths > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15145697#comment-15145697 ] ASF GitHub Bot commented on CB-10332: - Github user omefire commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r52820400 --- Diff: www/docs/en/dev/guide/platforms/android/index.md --- @@ -30,278 +30,676 @@ platform-centered shell tools or cross-platform Cordova CLI for development. For a comparison of the two development paths, see the [Overview](../../overview/index.html). For details on the CLI, see [The Command-Line Interface](../../cli/index.html). + ## Requirements and Support -Cordova for Android requires the Android SDK which could be installed +Cordova for Android requires the Android SDK which can be installed on OS X, Linux or Windows operation system. See the Android SDK's --- End diff -- 'operation' => 'operating' > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15137385#comment-15137385 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on the pull request: https://github.com/apache/cordova-docs/pull/471#issuecomment-181506432 I moved the lifecycle guide into the single page guide and added redirects to our `.htaccess` file that handle requests for all of the pages that got combined. > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15135197#comment-15135197 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on the pull request: https://github.com/apache/cordova-docs/pull/471#issuecomment-180609791 @rakatyal @nikhilkh @vladimir-kotikov @infil00p please look this over. I have some more updates to content that are coming, like [CB-10206](https://issues.apache.org/jira/browse/CB-10206). I just want to get the review started now. > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15135192#comment-15135192 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on the pull request: https://github.com/apache/cordova-docs/pull/471#issuecomment-180608678 Okay, I just forced pushed some major changes to this PR: * Addressed most of the code review * Deleted old pages and combined other pages into single page guide * Lots of miscellaneous content fixes and reorganization to fit the single page platform guide structure * Rebased to master Plugin guide is still separate, since that is going to move. Lifecycle is also separate, because I need to figure out what to do about that since I've been handing out links to that page all over the place because of the save-restore API changes. > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15132885#comment-15132885 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on the pull request: https://github.com/apache/cordova-docs/pull/471#issuecomment-180021130 @nikhilkh yes, I think the plan is to add a debugging section. > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15132930#comment-15132930 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51930488 --- Diff: www/docs/en/dev/guide/platforms/android/plugin.md --- @@ -31,12 +31,12 @@ platform and back. For another sample, see also the comments in [CordovaPlugin.java](https://github.com/apache/cordova-android/blob/master/framework/src/org/apache/cordova/CordovaPlugin.java). Android plugins are based on Cordova-Android, which consists of an -Android WebView with hooks attached to it. Plugins are represented as -class mappings in the `config.xml` file. A plugin consists of at +Android WebView with hooks attached to it. Plugins are represented as +class mappings in the `config.xml` file. A plugin consists of at least one Java class that extends the `CordovaPlugin` class, -overriding one of its `execute` methods. As best practice, the plugin -should also handle `[pause](../../../cordova/events/events.pause.html)` and `[resume](../../../cordova/events/events.resume.html)` events, along with any message -passing between plugins. Plugins with long-running requests, +overriding one of its `execute` methods. As a best practice, the plugin +should also handle [`pause`](../../../cordova/events/events.pause.html) and [`resume`](../../../cordova/events/events.resume.html) events, along with any message --- End diff -- @rakatyal Yep, I'll do that @nikhilkh Good point! > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15132923#comment-15132923 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51930197 --- Diff: www/docs/en/dev/guide/platforms/android/plugin.md --- @@ -72,7 +72,7 @@ Otherwise, the plugin may compile but still be unavailable to Cordova. One instance of a plugin object is created for the life of each `WebView`. Plugins are not instantiated until they are first referenced by a call from JavaScript, unless `` with an `onload` -`name` attribute is set to `"true"` in `config.xml`. E.g.: +`name` attribute is set to `"true"` in `config.xml`. For example, --- End diff -- I believe the `"android-package"` param is used for defining the Java package for your app so that the directory structure gets created correctly. See an example usage here: https://github.com/apache/cordova-plugin-camera/blob/master/plugin.xml#L64 > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131304#comment-15131304 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51801334 --- Diff: www/docs/en/dev/guide/platforms/android/index.md --- @@ -32,276 +32,152 @@ development. For a comparison of the two development paths, see the ## Requirements and Support +### Java Development Kit (JDK) + +Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) +or later. + +When installing on Windows you also need to set `JAVA_HOME` Environment Variable +according to JDK installation path (for example, `C:\Program Files\Java\jdk1.7.0_75`). + +### Android SDK + Cordova for Android requires the Android SDK which could be installed on OS X, Linux or Windows operation system. See the Android SDK's [System Requirements](http://developer.android.com/sdk/index.html#Requirements). - -Cordova supports Android 4.0.x (starting with Android API level 14) -and higher. As a general rule, Android versions become unsupported by Cordova as +Cordova's latest Android package supports up to Android [API-Level](http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) 23. +The supported Android API-Levels for the past few cordova-android releases can +be found in this table: + +cordova-android Version | Supported Android API-Levels +|- +5.X.X | 14 - 23 +4.1.X | 14 - 22 +4.0.X | 10 - 22 +3.7.X | 10 - 21 + +Please note that the versions listed here are for Cordova's Android package, +[cordova-android](https://github.com/apache/cordova-android), and not for the +Cordova CLI. To determine what version of Cordova's Android package is installed +in your Cordova project, run the command `cordova platform ls` in the directory +that holds your project. + +As a general rule, Android versions become unsupported by Cordova as they dip below 5% on Google's [distribution dashboard](http://developer.android.com/about/dashboards/index.html). -Android versions earlier than API level 10, and the 3.x versions (Honeycomb, -API levels 11-13) fall significantly below that 5% threshold. - -## Install Cordova Shell Tools - -If you want to use Cordova's Android-centered shell tools in -conjunction with the SDK, download Cordova from -[cordova.apache.org](http://cordova.apache.org). Otherwise ignore this -section if you plan to use the cross-platform CLI tool described in -[The Command-Line Interface](../../cli/index.html). -The Cordova download contains separate archives for each platform. Be -sure to expand the appropriate archive, `android` in this case, within -an empty directory. The relevant executible utilities are available -in the top-level `bin` directory. (Consult the __README__ file if -necessary for more detailed directions.) + Installing the Android SDK -These shell tools allow you to create, build, and run Android apps. -For information on the additional command-line interface that enables -plugin features across all platforms, see Using Plugman to Manage -Plugins. See Application Plugins for details on how to develop -plugins. - -## Install the Java Development Kit (JDK) - -Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) -or later. - -When installing on Windows you also need to set `JAVA_HOME` Environment Variable -according to JDK installation path (for example, C:\Program Files\Java\jdk1.7.0_75). - -## Install the Android SDK - -Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). Procceed with `Android Studio` if you plan +Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). +Proceed with Android Studio if you plan on developing new Cordova for Android plugins or using native tools to --- End diff -- For some reason this article says "Cordova for Android" all over the place and so I kept that up. This sentence was referring to plugins. Android Studio can be used with apps, but I think the better use case is with
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131321#comment-15131321 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51802704 --- Diff: www/docs/en/dev/guide/platforms/android/index.md --- @@ -32,276 +32,152 @@ development. For a comparison of the two development paths, see the ## Requirements and Support +### Java Development Kit (JDK) + +Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) +or later. + +When installing on Windows you also need to set `JAVA_HOME` Environment Variable +according to JDK installation path (for example, `C:\Program Files\Java\jdk1.7.0_75`). + +### Android SDK + Cordova for Android requires the Android SDK which could be installed on OS X, Linux or Windows operation system. See the Android SDK's [System Requirements](http://developer.android.com/sdk/index.html#Requirements). - -Cordova supports Android 4.0.x (starting with Android API level 14) -and higher. As a general rule, Android versions become unsupported by Cordova as +Cordova's latest Android package supports up to Android [API-Level](http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) 23. +The supported Android API-Levels for the past few cordova-android releases can +be found in this table: + +cordova-android Version | Supported Android API-Levels +|- +5.X.X | 14 - 23 +4.1.X | 14 - 22 +4.0.X | 10 - 22 +3.7.X | 10 - 21 + +Please note that the versions listed here are for Cordova's Android package, +[cordova-android](https://github.com/apache/cordova-android), and not for the +Cordova CLI. To determine what version of Cordova's Android package is installed +in your Cordova project, run the command `cordova platform ls` in the directory +that holds your project. + +As a general rule, Android versions become unsupported by Cordova as they dip below 5% on Google's [distribution dashboard](http://developer.android.com/about/dashboards/index.html). -Android versions earlier than API level 10, and the 3.x versions (Honeycomb, -API levels 11-13) fall significantly below that 5% threshold. - -## Install Cordova Shell Tools - -If you want to use Cordova's Android-centered shell tools in -conjunction with the SDK, download Cordova from -[cordova.apache.org](http://cordova.apache.org). Otherwise ignore this -section if you plan to use the cross-platform CLI tool described in -[The Command-Line Interface](../../cli/index.html). -The Cordova download contains separate archives for each platform. Be -sure to expand the appropriate archive, `android` in this case, within -an empty directory. The relevant executible utilities are available -in the top-level `bin` directory. (Consult the __README__ file if -necessary for more detailed directions.) + Installing the Android SDK -These shell tools allow you to create, build, and run Android apps. -For information on the additional command-line interface that enables -plugin features across all platforms, see Using Plugman to Manage -Plugins. See Application Plugins for details on how to develop -plugins. - -## Install the Java Development Kit (JDK) - -Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) -or later. - -When installing on Windows you also need to set `JAVA_HOME` Environment Variable -according to JDK installation path (for example, C:\Program Files\Java\jdk1.7.0_75). - -## Install the Android SDK - -Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). Procceed with `Android Studio` if you plan +Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). +Proceed with Android Studio if you plan on developing new Cordova for Android plugins or using native tools to -run and debug Android platform. Otherwise, `Android Stand-alone SDK Tools` -are enough to build and deploy Android application. +run and debug the Android platform. Otherwise, the Android Stand-alone SDK Tools +are enough to build
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131324#comment-15131324 ] ASF GitHub Bot commented on CB-10332: - Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51802949 --- Diff: www/docs/en/dev/guide/platforms/android/plugin.md --- @@ -31,12 +31,12 @@ platform and back. For another sample, see also the comments in [CordovaPlugin.java](https://github.com/apache/cordova-android/blob/master/framework/src/org/apache/cordova/CordovaPlugin.java). Android plugins are based on Cordova-Android, which consists of an -Android WebView with hooks attached to it. Plugins are represented as -class mappings in the `config.xml` file. A plugin consists of at +Android WebView with hooks attached to it. Plugins are represented as +class mappings in the `config.xml` file. A plugin consists of at least one Java class that extends the `CordovaPlugin` class, -overriding one of its `execute` methods. As best practice, the plugin -should also handle `[pause](../../../cordova/events/events.pause.html)` and `[resume](../../../cordova/events/events.resume.html)` events, along with any message -passing between plugins. Plugins with long-running requests, +overriding one of its `execute` methods. As a best practice, the plugin +should also handle [`pause`](../../../cordova/events/events.pause.html) and [`resume`](../../../cordova/events/events.resume.html) events, along with any message --- End diff -- Link these to events reference? > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands,
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131314#comment-15131314 ] ASF GitHub Bot commented on CB-10332: - Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51802258 --- Diff: www/docs/en/dev/guide/platforms/android/index.md --- @@ -32,276 +32,152 @@ development. For a comparison of the two development paths, see the ## Requirements and Support +### Java Development Kit (JDK) + +Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) +or later. + +When installing on Windows you also need to set `JAVA_HOME` Environment Variable +according to JDK installation path (for example, `C:\Program Files\Java\jdk1.7.0_75`). + +### Android SDK + Cordova for Android requires the Android SDK which could be installed on OS X, Linux or Windows operation system. See the Android SDK's [System Requirements](http://developer.android.com/sdk/index.html#Requirements). - -Cordova supports Android 4.0.x (starting with Android API level 14) -and higher. As a general rule, Android versions become unsupported by Cordova as +Cordova's latest Android package supports up to Android [API-Level](http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) 23. +The supported Android API-Levels for the past few cordova-android releases can +be found in this table: + +cordova-android Version | Supported Android API-Levels +|- +5.X.X | 14 - 23 +4.1.X | 14 - 22 +4.0.X | 10 - 22 +3.7.X | 10 - 21 + +Please note that the versions listed here are for Cordova's Android package, +[cordova-android](https://github.com/apache/cordova-android), and not for the +Cordova CLI. To determine what version of Cordova's Android package is installed +in your Cordova project, run the command `cordova platform ls` in the directory +that holds your project. + +As a general rule, Android versions become unsupported by Cordova as they dip below 5% on Google's [distribution dashboard](http://developer.android.com/about/dashboards/index.html). -Android versions earlier than API level 10, and the 3.x versions (Honeycomb, -API levels 11-13) fall significantly below that 5% threshold. - -## Install Cordova Shell Tools - -If you want to use Cordova's Android-centered shell tools in -conjunction with the SDK, download Cordova from -[cordova.apache.org](http://cordova.apache.org). Otherwise ignore this -section if you plan to use the cross-platform CLI tool described in -[The Command-Line Interface](../../cli/index.html). -The Cordova download contains separate archives for each platform. Be -sure to expand the appropriate archive, `android` in this case, within -an empty directory. The relevant executible utilities are available -in the top-level `bin` directory. (Consult the __README__ file if -necessary for more detailed directions.) + Installing the Android SDK -These shell tools allow you to create, build, and run Android apps. -For information on the additional command-line interface that enables -plugin features across all platforms, see Using Plugman to Manage -Plugins. See Application Plugins for details on how to develop -plugins. - -## Install the Java Development Kit (JDK) - -Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) -or later. - -When installing on Windows you also need to set `JAVA_HOME` Environment Variable -according to JDK installation path (for example, C:\Program Files\Java\jdk1.7.0_75). - -## Install the Android SDK - -Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). Procceed with `Android Studio` if you plan +Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). +Proceed with Android Studio if you plan on developing new Cordova for Android plugins or using native tools to -run and debug Android platform. Otherwise, `Android Stand-alone SDK Tools` -are enough to build and deploy Android application. +run and debug the Android platform. Otherwise, the Android Stand-alone SDK Tools +are enough to
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131319#comment-15131319 ] ASF GitHub Bot commented on CB-10332: - Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51802634 --- Diff: www/docs/en/dev/guide/platforms/android/index.md --- @@ -32,276 +32,152 @@ development. For a comparison of the two development paths, see the ## Requirements and Support +### Java Development Kit (JDK) + +Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) +or later. + +When installing on Windows you also need to set `JAVA_HOME` Environment Variable +according to JDK installation path (for example, `C:\Program Files\Java\jdk1.7.0_75`). + +### Android SDK + Cordova for Android requires the Android SDK which could be installed on OS X, Linux or Windows operation system. See the Android SDK's [System Requirements](http://developer.android.com/sdk/index.html#Requirements). - -Cordova supports Android 4.0.x (starting with Android API level 14) -and higher. As a general rule, Android versions become unsupported by Cordova as +Cordova's latest Android package supports up to Android [API-Level](http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) 23. +The supported Android API-Levels for the past few cordova-android releases can +be found in this table: + +cordova-android Version | Supported Android API-Levels +|- +5.X.X | 14 - 23 +4.1.X | 14 - 22 +4.0.X | 10 - 22 +3.7.X | 10 - 21 + +Please note that the versions listed here are for Cordova's Android package, +[cordova-android](https://github.com/apache/cordova-android), and not for the +Cordova CLI. To determine what version of Cordova's Android package is installed +in your Cordova project, run the command `cordova platform ls` in the directory +that holds your project. + +As a general rule, Android versions become unsupported by Cordova as they dip below 5% on Google's [distribution dashboard](http://developer.android.com/about/dashboards/index.html). -Android versions earlier than API level 10, and the 3.x versions (Honeycomb, -API levels 11-13) fall significantly below that 5% threshold. - -## Install Cordova Shell Tools - -If you want to use Cordova's Android-centered shell tools in -conjunction with the SDK, download Cordova from -[cordova.apache.org](http://cordova.apache.org). Otherwise ignore this -section if you plan to use the cross-platform CLI tool described in -[The Command-Line Interface](../../cli/index.html). -The Cordova download contains separate archives for each platform. Be -sure to expand the appropriate archive, `android` in this case, within -an empty directory. The relevant executible utilities are available -in the top-level `bin` directory. (Consult the __README__ file if -necessary for more detailed directions.) + Installing the Android SDK -These shell tools allow you to create, build, and run Android apps. -For information on the additional command-line interface that enables -plugin features across all platforms, see Using Plugman to Manage -Plugins. See Application Plugins for details on how to develop -plugins. - -## Install the Java Development Kit (JDK) - -Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) -or later. - -When installing on Windows you also need to set `JAVA_HOME` Environment Variable -according to JDK installation path (for example, C:\Program Files\Java\jdk1.7.0_75). - -## Install the Android SDK - -Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). Procceed with `Android Studio` if you plan +Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). +Proceed with Android Studio if you plan on developing new Cordova for Android plugins or using native tools to --- End diff -- Yeah all right. > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova >
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131311#comment-15131311 ] ASF GitHub Bot commented on CB-10332: - Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51801961 --- Diff: www/docs/en/dev/guide/platforms/android/index.md --- @@ -32,276 +32,152 @@ development. For a comparison of the two development paths, see the ## Requirements and Support +### Java Development Kit (JDK) + +Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) +or later. + +When installing on Windows you also need to set `JAVA_HOME` Environment Variable +according to JDK installation path (for example, `C:\Program Files\Java\jdk1.7.0_75`). + +### Android SDK + Cordova for Android requires the Android SDK which could be installed on OS X, Linux or Windows operation system. See the Android SDK's [System Requirements](http://developer.android.com/sdk/index.html#Requirements). - -Cordova supports Android 4.0.x (starting with Android API level 14) -and higher. As a general rule, Android versions become unsupported by Cordova as +Cordova's latest Android package supports up to Android [API-Level](http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) 23. +The supported Android API-Levels for the past few cordova-android releases can +be found in this table: + +cordova-android Version | Supported Android API-Levels +|- +5.X.X | 14 - 23 +4.1.X | 14 - 22 +4.0.X | 10 - 22 +3.7.X | 10 - 21 + +Please note that the versions listed here are for Cordova's Android package, +[cordova-android](https://github.com/apache/cordova-android), and not for the +Cordova CLI. To determine what version of Cordova's Android package is installed +in your Cordova project, run the command `cordova platform ls` in the directory +that holds your project. + +As a general rule, Android versions become unsupported by Cordova as they dip below 5% on Google's [distribution dashboard](http://developer.android.com/about/dashboards/index.html). -Android versions earlier than API level 10, and the 3.x versions (Honeycomb, -API levels 11-13) fall significantly below that 5% threshold. - -## Install Cordova Shell Tools - -If you want to use Cordova's Android-centered shell tools in -conjunction with the SDK, download Cordova from -[cordova.apache.org](http://cordova.apache.org). Otherwise ignore this -section if you plan to use the cross-platform CLI tool described in -[The Command-Line Interface](../../cli/index.html). -The Cordova download contains separate archives for each platform. Be -sure to expand the appropriate archive, `android` in this case, within -an empty directory. The relevant executible utilities are available -in the top-level `bin` directory. (Consult the __README__ file if -necessary for more detailed directions.) + Installing the Android SDK -These shell tools allow you to create, build, and run Android apps. -For information on the additional command-line interface that enables -plugin features across all platforms, see Using Plugman to Manage -Plugins. See Application Plugins for details on how to develop -plugins. - -## Install the Java Development Kit (JDK) - -Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) -or later. - -When installing on Windows you also need to set `JAVA_HOME` Environment Variable -according to JDK installation path (for example, C:\Program Files\Java\jdk1.7.0_75). - -## Install the Android SDK - -Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). Procceed with `Android Studio` if you plan +Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). +Proceed with Android Studio if you plan on developing new Cordova for Android plugins or using native tools to -run and debug Android platform. Otherwise, `Android Stand-alone SDK Tools` -are enough to build and deploy Android application. +run and debug the Android platform. Otherwise, the Android Stand-alone SDK Tools +are enough to
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131373#comment-15131373 ] ASF GitHub Bot commented on CB-10332: - Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51806333 --- Diff: www/docs/en/dev/guide/platforms/android/index.md --- @@ -32,276 +32,152 @@ development. For a comparison of the two development paths, see the ## Requirements and Support +### Java Development Kit (JDK) + +Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) +or later. + +When installing on Windows you also need to set `JAVA_HOME` Environment Variable +according to JDK installation path (for example, `C:\Program Files\Java\jdk1.7.0_75`). + +### Android SDK + Cordova for Android requires the Android SDK which could be installed on OS X, Linux or Windows operation system. See the Android SDK's [System Requirements](http://developer.android.com/sdk/index.html#Requirements). - -Cordova supports Android 4.0.x (starting with Android API level 14) -and higher. As a general rule, Android versions become unsupported by Cordova as +Cordova's latest Android package supports up to Android [API-Level](http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) 23. +The supported Android API-Levels for the past few cordova-android releases can +be found in this table: + +cordova-android Version | Supported Android API-Levels +|- +5.X.X | 14 - 23 +4.1.X | 14 - 22 +4.0.X | 10 - 22 +3.7.X | 10 - 21 + +Please note that the versions listed here are for Cordova's Android package, +[cordova-android](https://github.com/apache/cordova-android), and not for the +Cordova CLI. To determine what version of Cordova's Android package is installed +in your Cordova project, run the command `cordova platform ls` in the directory +that holds your project. + +As a general rule, Android versions become unsupported by Cordova as they dip below 5% on Google's [distribution dashboard](http://developer.android.com/about/dashboards/index.html). -Android versions earlier than API level 10, and the 3.x versions (Honeycomb, -API levels 11-13) fall significantly below that 5% threshold. - -## Install Cordova Shell Tools - -If you want to use Cordova's Android-centered shell tools in -conjunction with the SDK, download Cordova from -[cordova.apache.org](http://cordova.apache.org). Otherwise ignore this -section if you plan to use the cross-platform CLI tool described in -[The Command-Line Interface](../../cli/index.html). -The Cordova download contains separate archives for each platform. Be -sure to expand the appropriate archive, `android` in this case, within -an empty directory. The relevant executible utilities are available -in the top-level `bin` directory. (Consult the __README__ file if -necessary for more detailed directions.) + Installing the Android SDK -These shell tools allow you to create, build, and run Android apps. -For information on the additional command-line interface that enables -plugin features across all platforms, see Using Plugman to Manage -Plugins. See Application Plugins for details on how to develop -plugins. - -## Install the Java Development Kit (JDK) - -Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) -or later. - -When installing on Windows you also need to set `JAVA_HOME` Environment Variable -according to JDK installation path (for example, C:\Program Files\Java\jdk1.7.0_75). - -## Install the Android SDK - -Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). Procceed with `Android Studio` if you plan +Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). +Proceed with Android Studio if you plan on developing new Cordova for Android plugins or using native tools to -run and debug Android platform. Otherwise, `Android Stand-alone SDK Tools` -are enough to build and deploy Android application. +run and debug the Android platform. Otherwise, the Android Stand-alone SDK Tools +are enough to
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131293#comment-15131293 ] ASF GitHub Bot commented on CB-10332: - Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51800700 --- Diff: www/docs/en/dev/guide/platforms/android/index.md --- @@ -32,276 +32,152 @@ development. For a comparison of the two development paths, see the ## Requirements and Support +### Java Development Kit (JDK) + +Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) +or later. + +When installing on Windows you also need to set `JAVA_HOME` Environment Variable +according to JDK installation path (for example, `C:\Program Files\Java\jdk1.7.0_75`). + +### Android SDK + Cordova for Android requires the Android SDK which could be installed on OS X, Linux or Windows operation system. See the Android SDK's [System Requirements](http://developer.android.com/sdk/index.html#Requirements). - -Cordova supports Android 4.0.x (starting with Android API level 14) -and higher. As a general rule, Android versions become unsupported by Cordova as +Cordova's latest Android package supports up to Android [API-Level](http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) 23. +The supported Android API-Levels for the past few cordova-android releases can +be found in this table: + +cordova-android Version | Supported Android API-Levels +|- +5.X.X | 14 - 23 +4.1.X | 14 - 22 +4.0.X | 10 - 22 +3.7.X | 10 - 21 + +Please note that the versions listed here are for Cordova's Android package, +[cordova-android](https://github.com/apache/cordova-android), and not for the +Cordova CLI. To determine what version of Cordova's Android package is installed +in your Cordova project, run the command `cordova platform ls` in the directory +that holds your project. + +As a general rule, Android versions become unsupported by Cordova as they dip below 5% on Google's [distribution dashboard](http://developer.android.com/about/dashboards/index.html). -Android versions earlier than API level 10, and the 3.x versions (Honeycomb, -API levels 11-13) fall significantly below that 5% threshold. - -## Install Cordova Shell Tools - -If you want to use Cordova's Android-centered shell tools in -conjunction with the SDK, download Cordova from -[cordova.apache.org](http://cordova.apache.org). Otherwise ignore this -section if you plan to use the cross-platform CLI tool described in -[The Command-Line Interface](../../cli/index.html). -The Cordova download contains separate archives for each platform. Be -sure to expand the appropriate archive, `android` in this case, within -an empty directory. The relevant executible utilities are available -in the top-level `bin` directory. (Consult the __README__ file if -necessary for more detailed directions.) + Installing the Android SDK -These shell tools allow you to create, build, and run Android apps. -For information on the additional command-line interface that enables -plugin features across all platforms, see Using Plugman to Manage -Plugins. See Application Plugins for details on how to develop -plugins. - -## Install the Java Development Kit (JDK) - -Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) -or later. - -When installing on Windows you also need to set `JAVA_HOME` Environment Variable -according to JDK installation path (for example, C:\Program Files\Java\jdk1.7.0_75). - -## Install the Android SDK - -Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). Procceed with `Android Studio` if you plan +Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). +Proceed with Android Studio if you plan on developing new Cordova for Android plugins or using native tools to --- End diff -- new Cordova apps or Android plugins? > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project:
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131323#comment-15131323 ] ASF GitHub Bot commented on CB-10332: - Github user riknoll commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51802869 --- Diff: www/docs/en/dev/guide/platforms/android/index.md --- @@ -32,276 +32,152 @@ development. For a comparison of the two development paths, see the ## Requirements and Support +### Java Development Kit (JDK) + +Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) +or later. + +When installing on Windows you also need to set `JAVA_HOME` Environment Variable +according to JDK installation path (for example, `C:\Program Files\Java\jdk1.7.0_75`). + +### Android SDK + Cordova for Android requires the Android SDK which could be installed on OS X, Linux or Windows operation system. See the Android SDK's [System Requirements](http://developer.android.com/sdk/index.html#Requirements). - -Cordova supports Android 4.0.x (starting with Android API level 14) -and higher. As a general rule, Android versions become unsupported by Cordova as +Cordova's latest Android package supports up to Android [API-Level](http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) 23. +The supported Android API-Levels for the past few cordova-android releases can +be found in this table: + +cordova-android Version | Supported Android API-Levels +|- +5.X.X | 14 - 23 +4.1.X | 14 - 22 +4.0.X | 10 - 22 +3.7.X | 10 - 21 + +Please note that the versions listed here are for Cordova's Android package, +[cordova-android](https://github.com/apache/cordova-android), and not for the +Cordova CLI. To determine what version of Cordova's Android package is installed +in your Cordova project, run the command `cordova platform ls` in the directory +that holds your project. + +As a general rule, Android versions become unsupported by Cordova as they dip below 5% on Google's [distribution dashboard](http://developer.android.com/about/dashboards/index.html). -Android versions earlier than API level 10, and the 3.x versions (Honeycomb, -API levels 11-13) fall significantly below that 5% threshold. - -## Install Cordova Shell Tools - -If you want to use Cordova's Android-centered shell tools in -conjunction with the SDK, download Cordova from -[cordova.apache.org](http://cordova.apache.org). Otherwise ignore this -section if you plan to use the cross-platform CLI tool described in -[The Command-Line Interface](../../cli/index.html). -The Cordova download contains separate archives for each platform. Be -sure to expand the appropriate archive, `android` in this case, within -an empty directory. The relevant executible utilities are available -in the top-level `bin` directory. (Consult the __README__ file if -necessary for more detailed directions.) + Installing the Android SDK -These shell tools allow you to create, build, and run Android apps. -For information on the additional command-line interface that enables -plugin features across all platforms, see Using Plugman to Manage -Plugins. See Application Plugins for details on how to develop -plugins. - -## Install the Java Development Kit (JDK) - -Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) -or later. - -When installing on Windows you also need to set `JAVA_HOME` Environment Variable -according to JDK installation path (for example, C:\Program Files\Java\jdk1.7.0_75). - -## Install the Android SDK - -Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). Procceed with `Android Studio` if you plan +Install the [Android Stand-alone SDK Tools](http://developer.android.com/sdk/installing/index.html?pkg=tools) or [Android Studio](http://developer.android.com/sdk/installing/index.html?pkg=studio). +Proceed with Android Studio if you plan on developing new Cordova for Android plugins or using native tools to -run and debug Android platform. Otherwise, `Android Stand-alone SDK Tools` -are enough to build and deploy Android application. +run and debug the Android platform. Otherwise, the Android Stand-alone SDK Tools +are enough to build
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131333#comment-15131333 ] ASF GitHub Bot commented on CB-10332: - Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51803655 --- Diff: www/docs/en/dev/guide/platforms/android/plugin.md --- @@ -118,7 +118,8 @@ exception names as much as possible. The plugin's JavaScript does _not_ run in the main thread of the `WebView` interface; instead, it runs on the `WebCore` thread, as does the `execute` method. If you need to interact with the user -interface, you should use the following variation: +interface, you should use the [Activity's `runOnUiThread`][ref-runonuithread] --- End diff -- This appears very weird on the github rich diff. I hope it's better on the website? > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131355#comment-15131355 ] ASF GitHub Bot commented on CB-10332: - Github user rakatyal commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51805298 --- Diff: www/docs/en/dev/guide/platforms/android/tools.md --- @@ -19,206 +19,218 @@ license: > title: Android Shell Tool Guide --- - # Android Shell Tool Guide -This guide shows how to use Cordova's set of platform-centered shell -tools to develop Android apps. This development path, discussed in the -[Overview](../../overview/index.html), may offer you a greater range of development options than -the cross-platform CLI tool described in [The Command-Line Interface](../../cli/index.html). -For example, you need to use shell tools when deploying a custom -Cordova WebView alongside native components. Before using either -development path, you must first configure the Android SDK environment -as described in the [Android Platform Guide](index.html). +## Building with Gradle -To enable shell tools for Android, download Cordova from -[cordova.apache.org](http://cordova.apache.org). The download contains -separate archives for each platform. Expand each you wish to target, -`android` in this case. The relevant tools are typically available in -the top-level `bin` directory, otherwise consult the __README__ file -for more detailed directions. +As of **cordova-android@4.0.0**, Cordova for Android projects are built using +[Gradle](http://www.gradle.org/). For instructions on building with Ant, refer +to older versions of the documentation. -These tools allow you to create, build, and run Android apps. For -information on the additional command-line interface that enables -plugin features across all platforms, see Using Plugman to Manage -Plugins. See Application Plugins for details on how to develop -plugins. +### Gradle Properties -## Create a Project +It is possible to configure the Gradle build by setting the values of certain +[Gradle properties](https://docs.gradle.org/current/userguide/build_environment.html) +that Cordova exposes. The following properties are available to be set: -Run the `create` command, specifying the existing path to the project, -the reverse-domain-style package identifier, and the app's display -name. Here is the syntax for both Mac/Linux and Windows: + * **cdvBuildMultipleApks** (default: false) --- End diff -- Can we have these in a table? Makes it more readable. > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131806#comment-15131806 ] ASF GitHub Bot commented on CB-10332: - Github user nikhilkh commented on the pull request: https://github.com/apache/cordova-docs/pull/471#issuecomment-179666263 Should we add a section on "Diagnosing failures" - it could be part of a subsequent PR - in particular, talking about adb logcat or referencing appropriate Android docs. > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131792#comment-15131792 ] ASF GitHub Bot commented on CB-10332: - Github user nikhilkh commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51833532 --- Diff: www/docs/en/dev/guide/platforms/android/plugin.md --- @@ -155,27 +158,24 @@ thread, but do not want to block the `WebCore` thread either: ## Adding Dependency Libraries -If a plugin requires additional libraries to work, you can use -one of the following approaches to add them via `config.xml`. +If your Android plugin has extra dependencies, they must be listed in the +`plugin.xml` in one of two ways. -Option A. Via _Gradle_ reference, for example: - - - -This is a recommended approach as it allows multiple plugins -to refer to the same dependency library such as _gson_, -_android-support-v4_, _google-play-services_, etc and -_Gradle_ will resolve duplicate dependencies using its +The preferred way is to use the `` tag (see the +[Plugin Specification](../../../plugin_ref/spec.html) for more details). +Specifying libraries in this manner allows them to be resolved via Gradle's [Dependency Management logic](https://docs.gradle.org/current/userguide/dependency_management.html). - -Option B. As _JAR_ files placed to some plugin's folder and -linked using `lib-file`, for example: - - - -We recommend using this approach only if you are sure that -dependency jar is plugin specific and won't be used by -other plugins. Otherwise, there will be platform build issue. +This allows commonly used libraries such as _gson_, _android-support-v4_, +and _google-play-services_ to be used by multiple plugins without conflict. + +The second option is to use the `` tag to specify the location of --- End diff -- Does `framework` support a jar reference too? Are these mutually exclusive or `framework` is always preferred over `lib-file`? > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131782#comment-15131782 ] ASF GitHub Bot commented on CB-10332: - Github user nikhilkh commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51832927 --- Diff: www/docs/en/dev/guide/platforms/android/plugin.md --- @@ -31,12 +31,12 @@ platform and back. For another sample, see also the comments in [CordovaPlugin.java](https://github.com/apache/cordova-android/blob/master/framework/src/org/apache/cordova/CordovaPlugin.java). Android plugins are based on Cordova-Android, which consists of an -Android WebView with hooks attached to it. Plugins are represented as -class mappings in the `config.xml` file. A plugin consists of at +Android WebView with hooks attached to it. Plugins are represented as +class mappings in the `config.xml` file. A plugin consists of at least one Java class that extends the `CordovaPlugin` class, -overriding one of its `execute` methods. As best practice, the plugin -should also handle `[pause](../../../cordova/events/events.pause.html)` and `[resume](../../../cordova/events/events.resume.html)` events, along with any message -passing between plugins. Plugins with long-running requests, +overriding one of its `execute` methods. As a best practice, the plugin +should also handle [`pause`](../../../cordova/events/events.pause.html) and [`resume`](../../../cordova/events/events.resume.html) events, along with any message --- End diff -- Should you link to android lifecyle here? > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131783#comment-15131783 ] ASF GitHub Bot commented on CB-10332: - Github user nikhilkh commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51833065 --- Diff: www/docs/en/dev/guide/platforms/android/plugin.md --- @@ -72,7 +72,7 @@ Otherwise, the plugin may compile but still be unavailable to Cordova. One instance of a plugin object is created for the life of each `WebView`. Plugins are not instantiated until they are first referenced by a call from JavaScript, unless `` with an `onload` -`name` attribute is set to `"true"` in `config.xml`. E.g.: +`name` attribute is set to `"true"` in `config.xml`. For example, --- End diff -- What does the `android-package` stand for? > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15131788#comment-15131788 ] ASF GitHub Bot commented on CB-10332: - Github user nikhilkh commented on a diff in the pull request: https://github.com/apache/cordova-docs/pull/471#discussion_r51833427 --- Diff: www/docs/en/dev/guide/platforms/android/index.md --- @@ -32,276 +32,152 @@ development. For a comparison of the two development paths, see the ## Requirements and Support +### Java Development Kit (JDK) + +Install [Java Development Kit (JDK) 7](http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html) +or later. + +When installing on Windows you also need to set `JAVA_HOME` Environment Variable +according to JDK installation path (for example, `C:\Program Files\Java\jdk1.7.0_75`). + +### Android SDK + Cordova for Android requires the Android SDK which could be installed on OS X, Linux or Windows operation system. See the Android SDK's [System Requirements](http://developer.android.com/sdk/index.html#Requirements). - -Cordova supports Android 4.0.x (starting with Android API level 14) -and higher. As a general rule, Android versions become unsupported by Cordova as +Cordova's latest Android package supports up to Android [API-Level](http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) 23. +The supported Android API-Levels for the past few cordova-android releases can +be found in this table: + +cordova-android Version | Supported Android API-Levels +|- +5.X.X | 14 - 23 --- End diff -- I don't have better ideas but this will certainly require some maintenance every time we change the API level. > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for
[jira] [Commented] (CB-10332) Improve Android Guide
[ https://issues.apache.org/jira/browse/CB-10332?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=15125939#comment-15125939 ] ASF GitHub Bot commented on CB-10332: - Github user vladimir-kotikov commented on the pull request: https://github.com/apache/cordova-docs/pull/471#issuecomment-177849723 @riknoll, +1, makes sense > Improve Android Guide > - > > Key: CB-10332 > URL: https://issues.apache.org/jira/browse/CB-10332 > Project: Apache Cordova > Issue Type: Task > Components: Docs >Reporter: Raghav >Assignee: Richard B Knoll > Labels: Docs-6.x > > We did a document scrub and found the following issues. Please feel free to > correct other things as well. > - Android Platform Guide > -- Install Cordova Shell tools is out of date > -- Environment variable instructions for Windows are out of date > -- Emulator section can just point to > http://developer.android.com/tools/devices/emulator.html > -- Lots of duplicated content for create/build/deploy from CLI page > -- Page keeps switching between CLI and platform-centric workflow > - Android Shell Tool Guide > -- Second paragraph is out of date > -- Create/build/run/logging/clean should be clear that this is the > platform-centric workflow. Also duplicated in Android Platform guide > -- Platform-centric workflow should probably just get its own explicit page > -- Signing an app doesn't actually say how to sign an app. Gives arguments > for some mystery command > --- Does this belong in our docs? We might just mention it and point to > Google's app signing instructions > - Android WebViews > -- Needs investigation if this is still supported. > --- Step 1 is wrong (should be getting cordova-android by cloning or from npm) > --- Step 3 needs to have instructions for adding jars to gradle > --- Step 5 is out of date. CordovaActivity does not implement > CordovaInterface... Think they should be extending/modifying CordovaActivity. > Needs investigation > --- Step 6 does not appear to be camera plugin specific > --- Step 7 example is useless, it needs to be fleshed out > - Android plugins > -- Should be moved to plugin developer docs > -- Need a reference for the classes that plugins have access to > --- CordovaWebView, CallbackContext, CordovaPlugin, etc. > --- Most already have javadoc > -- Android Integration should be renamed and link to the Android classes it's > talking about > -- Debugging Android plugins is out of date (mentions Eclipse and jars) and > should probably be fleshed out a bit > - Android Configuration > -- Should be a reference > - Upgrading Android > -- Ends at 4.0.0 (current is 4.1.1, soon to be 5.0.0) > -- Needs to be reorganized in some way > --- The instructions seem to be pretty much the same for versions 1.6.0 + > -- Goes back to the phonegap days! Should probably only include Cordova > versions (1.5.0 +) > -- Upgrade to 1.8.0 from 1.7.0 repeated twice > -- Upgrade to 1.8.0 from 1.8.0 is a typo > General guidelines: > - While giving examples, keep them short. Do not repeat for all > plugins/platforms. > - Remove all references to cordova plugin registry. > - Remove Tizen references. The platform is deprecated > (http://markmail.org/message/hryg6sjswecpgndu) > - Keep information up to date for the platforms, CLI and plugins -- This message was sent by Atlassian JIRA (v6.3.4#6332) - To unsubscribe, e-mail: issues-unsubscr...@cordova.apache.org For additional commands, e-mail: issues-h...@cordova.apache.org