Skip to content

Latest commit

 

History

History
127 lines (79 loc) · 3.31 KB

BUILD.md

File metadata and controls

127 lines (79 loc) · 3.31 KB
Raw

Build

npm run installCordova

All the necessary plugins will be installed as well.

Android

Preriquisites

  • Android SDK
  • Ant

SDK

Download the SDK from https://developer.android.com/sdk/installing/index.html?pkg=tools. Android Studio is not required.

Move the SDK to a place on yur file system and refer to it on the .bashrc or .bash_profile file.

export ANDROID_HOME=~/Library/Android/sdk

Once it is done, you may need to run source ~/.bashrc or source ~/.bash_profile to update the configuration

Ant

# iOS
brew install ant

# Linux
sudo apt-get install ant

Build and run dev version (Non minified and debug ON)

Plug your device in if you have one (make sure your device is listed by running: $ adb devices) or let Android emulator handle it.

# Dump dev files within the www folder
npm run dumpdev

npm run runAndroid

NB: If you want to test the minification you could also run the prod version on debug mode by using npm run dumpprod instead of npm run dumpdev

Debug

Open Chrome and dump this in the address bar: chrome://inspect/#devices

If your device is connected and in USB mode you will see your application that you can inspect using Chrome dev tools.

iOS

Preriquisites

  • OSX
  • XCode
  • iOS Simulator
  • Provisioning profile

iOS9

Also you will need to disabled bitcode: Project > Build Settings > Build Options > Enable Bitcode = No

iOS simulator

sudo npm install -g ios-sim ios-deploy

Open project in Xcode

If you have ran npm run installCordova correctly you should have a Xcode project file located in /platforms/ios/*.xcodeproj. Open it by double clicking it.

Build and run emulated dev version (Non minified and debug ON)

Plug your device in if you have one or let iOS simulator handle it.

# Dump dev files within the www folder
npm run dumpdev

npm run emulateIOS

NB: If you want to test the minification you could also run the prod version on debug mode by using npm run dumpprod instead of npm run dumpdev

Build and run on device dev version (Non minified and debug ON)

For details about various requirements to deploy to a device, refer to the Cordova article: Getting Started with iOS. Briefly, you need to do the following before deploying:

  1. Join the Apple iOS Developer Program.
  2. Generate a certificate http://wiki.genexus.com/commwiki/servlet/hwiki?Create+a+Certificate+Signing+Request+in+a+MAC,
  3. Create a Provisioning Profile within the iOS Provisioning Portal. You can use its Development Provisioning Assistant to create and install the profile and certificate Xcode requires.
  4. Verify that the Code Signing section's Code Signing Identity within the project settings is set to your provisioning profile name.
# Dump dev files within the www folder
npm run dumpdev

npm run runIOS

URL whitelist

Add you webservice URL to the config.xml file

<allow-navigation href="http://example.com/*" />

More details: https://github.com/apache/cordova-plugin-whitelist

Debug

To have logs dunp in the terminal you can use --consolelogs options

npm run runIOS -- --consolelogs