Using PhoneGap to create an Android APK: Difference between revisions

From NSB App Studio
Jump to navigation Jump to search
Removed iOS specific info and updated build docs link.
No edit summary
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''''As of Oct 1, 2020, the PhoneGap service was discontinued by Adobe. This page is obsolete.'''''
== Purpose ==
== Purpose ==


The purpose of this tutorial is to show how to use PhoneGap to turn an App Studio project into a native Android app (.apk).
The purpose of this tutorial is to show how to use PhoneGap to turn an AppStudio project into a native Android app (.apk).


Normally, App Studio produces webapps, which are installed through the browser and can be saved to the Home screen. If you want to create an app which is distributed as an Android APK file, you need to compile it using the Android SDK. PhoneGap lets you do this with no change to your code.
Normally, AppStudio produces webapps, which are installed through the browser and can be saved to the Home screen. If you want to create an app which is distributed as an Android APK file, you need to compile it using the Android SDK. PhoneGap lets you do this with no change to your code.


PhoneGap also gives you access to [http://www.phonegap.com/about/feature features] that are not available to App Studio. These include the compass, contacts and notifications. In addition, you can develop your own native code extensions. Here's a good introduction to [http://hiediutley.com/2011/03/28/phonegap-tutorial-series-3-extending-the-phonegap-api/ creating PhoneGap plugins].
PhoneGap also gives you access to [http://www.phonegap.com/about/feature features] that are not available to AppStudio. These include the compass, contacts and notifications. In addition, you can develop your own native code extensions. Here's a good introduction to [http://hiediutley.com/2011/03/28/phonegap-tutorial-series-3-extending-the-phonegap-api/ creating PhoneGap plugins].


PhoneGap has two methods of doing this. The easier one is [http://build.phonegap.com/apps PhoneGap Build]. Use "Build Native App with PhoneGap" on the Run menu to upload your project to their site. In a few minutes, you can download app-store ready apps for Apple iOS, Google Android, Palm, Symbian, BlackBerry and more.
PhoneGap has two methods of doing this. The easier one is [http://build.phonegap.com/apps PhoneGap Build]. Use "Build Native App with PhoneGap" on the Run menu to upload your project to their site. In a few minutes, you can download app-store ready apps for Apple iOS, Google Android and Windows Phone.


The more complex method is the PhoneGap CLI. You will need to download the full development SDK, install and configure, then compile on your own machine. This method is free, but can be time consuming and tricky to set up.
The more complex method is the [[PhoneGap CLI]]. You will need to download the full development SDK, install and configure, then compile on your own machine. This method is free, but can be time consuming and tricky to set up.


Here is a full comparison of [[Web_Apps_Compared_to_PhoneGap_Apps|Web Apps vs. PhoneGap apps]].
Here is a full comparison of [[Web_Apps_Compared_to_PhoneGap_Apps|Web Apps vs. PhoneGap apps]].
Line 17: Line 19:
To use PhoneGap Build, choose "Build Native App with PhoneGap" under the Run menu. Your app will be uploaded to PhoneGap's compilation service. You can check on the status of the builds using "Get Native Build Status". Files are usually ready to download in a minute or so.
To use PhoneGap Build, choose "Build Native App with PhoneGap" under the Run menu. Your app will be uploaded to PhoneGap's compilation service. You can check on the status of the builds using "Get Native Build Status". Files are usually ready to download in a minute or so.


App Studio installs with a demo PhoneGap Build account. You'll want to set up your own account to use. It's quick and easy to do.
AppStudio installs with a demo PhoneGap Build account. You'll want to set up your own account for your use. It's quick and easy to do. Here's a video on using PhoneGap Build: https://www.youtube.com/watch?v=EjP8oknI6Mw
 
PhoneGap has a [[Phonegap_debugger|handy debugger]] - it's essential when things go wrong.


[[File:PhonegapStatus.png]]
[[File:PhonegapStatus.png]]
Line 25: Line 25:
== PhoneGap CLI ==
== PhoneGap CLI ==


The best instructions for using the PhoneGap CLI are on [http://docs.phonegap.com/en/3.5.0/guide_overview_index.md.html#Overview PhoneGap's website].
Information on using the PhoneGap CLI with AppStudio is [[PhoneGap CLI|here]].
 
In your PhoneGap project's folder, you will have a www folder. On the Deploy Options screen, use the 'Deploy to local or DropBox public folder' option. Put path of the www folder in 'Local Path'. Deploy will then copy the proper files into the www folder.
 
== PhoneGap Debugger ==
You can debug a PhoneGap app (created from NSB AppStudio) on the Android Emulator. Here's how:
 
1. open a DOS console
 
2. launch emulator on my "nsb" image (created with [AndroidSDK_PATH]\AVD Manager.exe)
<pre>
[AndroidSDK_PATH]\tools\emulator.exe -avd nsb
</pre>
 
3. install pkg on the only launched emulator
<pre>
[AndroidSDK_PATH]\platform-tools\tools\adb.exe -e install e:\MyApp-debug.apk
</pre>
or reinstall:
<pre>
[AndroidSDK_PATH]\platform-tools\tools\adb.exe -e install -r e:\MyApp_Test-debug.apk)
</pre>
 
4. show Android emulator logs in the DOS console
<pre>
[AndroidSDK_PATH]\platform-tools\tools\adb.exe logcat
 
or show only PhoneGap logs in the DOS Console
 
[AndroidSDK_PATH]\platform-tools\tools\adb.exe logcat CordovaLog:D *:S
</pre>
 
see: http://wildermuth.com/2013/4/30/Debugging_PhoneGap_with_the_Android_Console


== Google Play Store ==
== Google Play Store ==
Line 64: Line 32:


http://www.youtube.com/watch?v=26pWIWj9QRk
http://www.youtube.com/watch?v=26pWIWj9QRk
PhoneGap's documentation is here:
http://docs.build.phonegap.com/en_US/signing_signing-android.md.html

Latest revision as of 15:55, 10 November 2020

As of Oct 1, 2020, the PhoneGap service was discontinued by Adobe. This page is obsolete.

Purpose

The purpose of this tutorial is to show how to use PhoneGap to turn an AppStudio project into a native Android app (.apk).

Normally, AppStudio produces webapps, which are installed through the browser and can be saved to the Home screen. If you want to create an app which is distributed as an Android APK file, you need to compile it using the Android SDK. PhoneGap lets you do this with no change to your code.

PhoneGap also gives you access to features that are not available to AppStudio. These include the compass, contacts and notifications. In addition, you can develop your own native code extensions. Here's a good introduction to creating PhoneGap plugins.

PhoneGap has two methods of doing this. The easier one is PhoneGap Build. Use "Build Native App with PhoneGap" on the Run menu to upload your project to their site. In a few minutes, you can download app-store ready apps for Apple iOS, Google Android and Windows Phone.

The more complex method is the PhoneGap CLI. You will need to download the full development SDK, install and configure, then compile on your own machine. This method is free, but can be time consuming and tricky to set up.

Here is a full comparison of Web Apps vs. PhoneGap apps.

PhoneGap Build

To use PhoneGap Build, choose "Build Native App with PhoneGap" under the Run menu. Your app will be uploaded to PhoneGap's compilation service. You can check on the status of the builds using "Get Native Build Status". Files are usually ready to download in a minute or so.

AppStudio installs with a demo PhoneGap Build account. You'll want to set up your own account for your use. It's quick and easy to do. Here's a video on using PhoneGap Build: https://www.youtube.com/watch?v=EjP8oknI6Mw

PhoneGap CLI

Information on using the PhoneGap CLI with AppStudio is here.

Google Play Store

To list your app in the Google Play Store (or build a non-debug .apk), you will need to sign it. Here's a video showing how:

http://www.youtube.com/watch?v=26pWIWj9QRk