One Click Mobile Readme

In One Click Pack Html5 Web Apps into Native Android/IOS App using MIT Licensed AppWeb Runtime

One Click Mobile Packer is a tool to Pack Html Web Apps into Multi-Platform Application Run time to create Android/IOS Mobile Native Apps

It is part of toolkit for developing Portable Apps. Portable Apps are Apps (UI, Data, File and Interaction) which can be redeployed from one run time environment to another run time environment

Major Features (Free* Tool)

1. Convert any Html5 Web App into Mobile Hybrid Native Apps using a MIT Licensed AppWeb Runtime
2. Prototype using Html before developing a fully native app.
3. Build and publish your own WebApp Runtime using Xamarin Tools
4. Upgrade incrementally from Html5 App Page(s) to Native App Screen(s) using Xamarin Tools
5. Packing and Signing of IOS IPA in Windows which enables developing of IOS Apps without a Mac (Still require to pay 99$ to Apple to Get Developer License)
6. JarSigning of Android APK without JDK to reduce dependency on prerequisite tools
7. Dependency less Command Line tools to install Android/IOS APK and IPA files

Example Apps with MIT Licensed AppWeb Runtime(s)

1. Basic AppWeb Runtime (app.web.v1.apk | app.web.v1.ipa) which can be used to package any static (Html/Js/Css) webapp
2. Secure AppWeb Runtime (app.secure.v1.apk | app.secure.v1.ipa) which implement(s) a backend Json Web Service to implement login/logoff/change password/manage role functionality accessable using ajax calls from a JQuery Mobile Web app

Status of the Tool

Major Feature complete Beta Pre-release tested in Windows and MacOsX. *Testing in linux of the various command line utilities is pending. The App Web Runtime for packing web apps is alpha quality.

Prerequisites

1. Mono for MacOSx and Linux to run the tool
2. Code Sign Identity in Keychain or p12 file and Mobile Provisioning File for signing IOS IPA
3. ITunes to install the packed/signed IPA (Can install using command line also)

Installation

1. Install the Prerequisites (Mono if required)
2. Install BTSync and create a Read Only Sync Folder using the Public ReadOnly Key, BKAXCWT7FJCINI6IO5SRJ3LKA4RL6LSBQ and Wait for BTSync to download the OneClickPackage tools to your PC/Notebook
3. Alternate Install Git and Clone the OneClickMobile Repository https://github.com/Arshu/OneClickMobile

Verify Installation of Sample Apps in Android (Windows/Mac/Linux*)

1. Connect your Android Device to PC using USB cable after ensuring your Device USB drivers are installed
2. Go to Runtime Directory under OneClickMobile Root folder
   • For Mac/Linux run setpermission.sh in Terminal after executing chmod 755 setpermission.sh to set the chmod permissions of the sample .command and .sh files
   • Run app.web.v1.apk.bat in Windows or app.web.v1.apk.command or app.web.v1.apk.sh in Mac/Linux
3. Expected Result : App Web is installed into android device
4. Can also install the other AppWeb Runtimes to verify successfull installation
5. Warning : Android 4 and above requires WIFI to be ON for the webview to load the Web Page. IOS does not not suffer from this limitation.

Verify Packing of Sample App in Android (Windows/Mac/Linux)

<li>
	Go to Root Directory of OneClickMobile folder
	<ul>
		<li>
			For Mac/Linux run chmod 755 OneClickMobile.command in Terminal

		</li>
		<li>
			Run OneClickMobile.exe in Windows or OneClickMobile.command or OneClickMobile.sh in Mac/Linux
		</li>
	</ul
</li>
<li>
	Expected Result:
	<ul>
		<li>
			Android Output Directory having a <strong>app.web.v1.apk</strong> files with corresponding install batch files
		</li>
		<li>
			Configuration File : <strong>OneClickMobileConfig.txt</strong>
		</li>
		<li>
			Log File : <strong>OneClickMobileLog.html</strong>
		</li>
		<li>
			Licence File : <strong>OneClickMobile.lic</strong> License
		</li>
	</ul
</li>
<li>
	View the Log File for Successfull Packing of WebApp to a Android Hybrid App
</li>
<li>
	Run the generated install file app.web.v1.apk.bat or app.web.v1.apk.command to install the app into the Android device.
</li>
<li>
	A Default Configuration File will be generated with all the default values  filled which has been used for Packaging which can be changed and rerun using the updated configuration file.
</li>
<li>
	A Keystore/p12 key which is used for signing the Android App will be auto generated using the default password configured in the Configuration File and stored in the Keys directory under the Runtime directory.
</li>
<li>
	Even though app.web.v1.ipa gets generated, it will be unsigned since the Identify and password are not configured and hence cannot be directly installed into IOS Device.
</li>
<li>
	* A CSR File and a Private Key file will be generated under Keys directory using the default password configured in the Configuration File. This CSR file can be upload to Apple IOS Developer Site to get a Signed Developer Certificate which can be again copied to the Keys directory for the system to merge the Certificate and Private Key to generate a P12 File which can be used to codesign IOS Apps. 
</li>

Verify Packing of Sample App in IOS (Mac)

1. Configure for IOS using OneClickMobileConfig.txt:
   • Set IOSSignIdentity to Developer Identity in KeyChain
   • Set IOSProvisioningFilePath to the Mobile Provisioning File Path
2. Go to Root Directory of OneClickMobile folder
   • For Mac/Linux run chmod 755 OneClickMobile.command in Terminal

     		</li>
     		<li>
     			Run OneClickMobile.exe in Windows or OneClickMobile.command or OneClickMobile.sh in Mac/Linux
     		</li>
     	</ul
     </li>
     <li>
     	Expected Result:
     	<ul>
     		<li>
     			IOS Output Directory having a <strong>app.web.v1.ipa</strong> files with corresponding install batch files
     		</li>
     		<li>
     			Log File : <strong>OneClickMobileLog.html</strong>
     		</li>
     	</ul
     </li>
     

Output of the OneClickMobile tool when run first time will generate the OneClickMobileConfig.txt file for configuration and the License file to submit to get a Basic or Enterprise signed license file

Getting Started

Prepare your WebApp as a Zip File with the Index.html file in the root directory of the Zip File and configure the Path of the Zip in the OneClickMobileConfig.txt file

Getting Started (Android) (Windows/Mac/Linux*)

1. Configure for Android using OneClickMobileConfig.txt:
   • Set Input WebAppFilePath
   • Optional Configure KeyStore Generation Options for Auto Generation of New Keystore or Optional Set the Keystore Path, Password and Alias to use your existing keystore.
2. Run the Tool by Clicking the OneClickMobile.exe/OneClickMobile.command in Windows/Mac respectively
   • Use the Terminal program in Mac/Linux to change mode the OneClickMobile.command/OneClickMobile.sh file to have execute permission (chmod 755 OneClickMobile.command)
3. The tool will pack the example WebApp in InputWebApp with the Provided Free APK App Runtime and generate an Android App (*.apk) in the OutputAndroidApp folder.
4. Connect your Android Mobile Phone to your PC/Notebook and click the generated install file (*.bat) to install to your phone.

Getting Started (IOS) (Mac)

1. Download your development certificate from Apple and Install it into your Keychain (Mac)
2. Download your mobile provisioning profile and save it into the Keys Folder under the Runtime Directory.
3. Configure for IOS Apple CodeSign using OneClickMobileConfig.txt:
   • Set Input WebAppFilePath
   • Set IOSSignIdentity to Developer Identity in KeyChain (Will auto encrypt in Config File)
   • Set IOSProvisioningFilePath to the Mobile Provisioning File Path
4. Run the Tool by Clicking the OneClickMobile.exe/OneClickMobile.command in Windows/Mac respectively
   1. Use the Terminal program in Mac/Linux to change mode the OneClickMobile.command file to have execute permission (chmod 755 OneClickMobile.command)
5. The tool will pack the example WebApp in InputWebApp with the Provided Free IPA Runtime and generate an Apple App (*.ipa) in the OutputIOSApp folder.
6. Connect your IPhone to your PC/Notebook and click the generated IPA file to open in ITunes and install in your IPhone or click the install batch file to install

Getting Started (IOS) (Windows)

1. Download your mobile provisioning profile and save it into the Keys Folder under the Runtime Directory.
2. Configure for IOS Custom CodeSign using OneClickMobileConfig.txt:
   • Set Input WebAppFilePath
   • Set IOSSignKeyFilePath to a P12 file of the Developer Certificate
   • Set IOSSignKeyPassword of the P12 file ((Will auto encrypt in Config File)
   • Set IOSProvisioningFilePath to the Mobile Provisioning File Path
3. Run the Tool by Clicking the OneClickMobile.exe/OneClickMobile.command in Windows/Mac respectively
   1. Use the Terminal program in Mac/Linux to change mode the OneClickMobile.command file to have execute permission (chmod 755 OneClickMobile.command)
4. The tool will pack the example WebApp in InputWebApp with the Provided Free IPA Runtime and generate an Apple App (*.ipa) in the OutputIOSApp folder.
5. Connect your IPhone to your PC/Notebook and click the generated IPA file to open in ITunes and install in your IPhone or click the install batch file to install

Generation of Keystore/P12 file for Android Signing

1. The OneClickMobile Packager will generate a Keystore file using keytool if the parameters required for Keystore generation are configured in the OneClickMobileConfig.txt file and keytool is installed
2. The OneClicMobile Packager will also generate a p12 keystore file if the parameters required for Keystore geneneration are configured in the OneClickMobileConfig.txt file
3. The main parameters required to be configured are
   • AndroidKeyStorePwd (Will auto encrypt in Config File)
   • AndroidKeyPwd (Will auto encrypt in Config File)
   • AndroidKeyAlias
   • AndroidDistinguishedName
   • AndroidKeyValidity

Generation of P12 file for IOS Signing in Windows

1. A P12 file can be exported from KeyChain of Mac having the developer identity and used in windows
2. OneClickMobile will auto generate a Private Key and CSR for submiting to Apple IOS Developer Center to get a Developer Identity Certificate
3. The main parameters required to be configured are
   • IOSSignKeyPassword (Will auto encrypt in Config File)
   • IOSSignEmail
   • IOSSignCommonName
4. Once the Developer certificate is copied to the Keys directory having the same name as the CSR Certificate with a Cert Extension, the OneClickMobile Tool will merge the Private Key of the CSR and the Developer Certificate to generate a P12 file secured using the configured password

Difference from PhoneGAP/Cordova

1. Architectural Difference:
   1. PhoneGAP/Cordova is based on Frontend Client Side (Browser View) based solution
   2. AppWeb Runtime is based on both Frontend Client Side (Browser View) and Backend Server Side (Json Service), merging the Browser and Server into a Standalone Runtime using the latest web architectural pattern, namely API First Design.
2. Development Difference:
   • PhoneGAP/Cordova is based on purely Html/Js/Css and enhancing with platform native components leads to writing plug-ins in multiple languages of the respective native platforms
   • Portable App is based on not only Html/Js/Css for coding the frontend, but also has facilities for coding a embedded backend in C#, F#, Lua with full access to platform native components using Xamarin Tool using a single language.
   • Accessing Device Functions using a Web Service Architecture provides better performance and architectual similiarlity to web based apps. It also enable incremental migration of webview based apps to native view based apps with a lot more code reuse.
3. Business Justification:
   • Web Applications are suited for discovery and Mobile Apps are suited for engagement and hence most applications/services need to be developed in both web technologies and mobile technologies. Having similiar architecture enables cost savings and rapid iteration of features.
   • Mobile Web technologies can never approach the performance of Native App and hence it is allways adviceable to have a migration path to Native Views once the cost is justified and hence having a framework which allows reuse when migrating from web view based to native view based is more prudent
   • Architecting a application into Portable Application Layer and Domain Specific Multi Platform Application Runtime layer provides a cost advantage and flexibility in deploying to multiple platforms for the same development cost.

OneClickMobile Pricing

1. FREE - The One Click Mobile Packer is free with restriction on the number of runs per day (Resetable 3 pack runs per day) [Can clear the temporary directory/config file to get unlimited runs].
2. 99$ BASIC - The One Click Mobile Packer can be enabled with unlimited (Resetabble 25 pack runs per day) per pc for a licence fees of USD 99/- per year per device.
3. 999$ ENTERPRISE - The One Click Mobile Packer can be customized for batch packing in a build server for a licence fees of USD 999/- per year per server.

OneClickMobile Refundable Subscription

1. Subscription of Basic or Enterprise option for 5 years.
2. The Yearly Subscription Fees will be refunded as Equity equivalent with the Yearly Subscription amount or the Subscription amount based on the interests of the subscriber

Roadmap

1. Support FAT Binary and 64 bit Binary Codesign of IOS Apps
2. Integrate the Signing into the App Web Runtime Component (Used to develop App Web Runtimes) to enable apps to generate signed apps
3. Publish Domain (Business) based AppWebs and AppWeb Runtimes demonstranting Access to Mobile Device Features
4. Enable Packing of PhoneGAP based Apps
5. Publish Lua/Swift/Java based Runtime for packing AppWebs