https://github.com/mortnod/instabart-apps

Cordova based app for smartphones (Android and iOS)
https://github.com/mortnod/instabart-apps

Last synced: 27 days ago
JSON representation

Cordova based app for smartphones (Android and iOS)

• Host: GitHub
• URL: https://github.com/mortnod/instabart-apps
• Owner: mortnod
• Created: 2014-07-15T20:04:41.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2017-08-24T10:30:56.000Z (over 7 years ago)
• Last Synced: 2024-05-18T21:53:59.543Z (7 months ago)
• Language: JavaScript
• Size: 1.28 MB
• Stars: 1
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-ntnu - Instabart app - Instabart for your phone. (iOS/Android apps)

README

        
Instabart apps (Android and iOS)

==============

This is a Cordova based project that wraps the Instabart code into a native app.

## Getting started

*  Clone the app repository

    * `git clone https://github.com/mortenvn/instabart-apps.git`

* Clone the [main instabart repository](https://github.com/mortenvn/instabart.git). This is the same repo that is used at instabart.no

    * `cd instabart-apps`

    * `git clone https://github.com/mortenvn/instabart.git www`

* From the www folder, install grunt dependencies and generate production code

    * `cd www`

    * `npm install`

    * `npm install -g grunt-cli` (might need sudo)

    * `grunt phone`

- Install the Cordova CLI, generate android and iOS projects and manually add custom app files

    * `npm install -g cordova` (might need sudo)

    * `cordova add platform android`

    * `cordova add platform ios`

    * For Android, manually update `AndroidManifest.xml` with the correct minSDKVersion. As of now, the proper value is ``

- Add Cordova plugins

    * `cordova plugin add cordova-plugin-statusbar`

    * `cordova plugin add cordova-plugin-device`

    * `cordova plugin add cordova-plugin-inappbrowser`

## Test the app!

- **Test in emulator:** `cordova emulate [android|ios]`

- **Test using USB connected phone:** `cordova run [android|ios]`

## Updating the app

### Get the newest version of Instabart

As the [main project](https://github.com/mortenvn/instabart.git) evolves, the **www** files in the cordova project will have to be updated. Luckily, since we just cloned the project, getting the newest files is super easy.

From the **www** folder:

1. `grunt`

2. `git pull origin master`

3. `grunt phone`

### Update Android SDK

Run `android sdk` and download the newest versions of Android.

### Update Cordova

Run the following commands in terminal:

`sudo npm update -g cordova`

`cordova platform update android`

`cordova platform update ios`

## Generating production files

### Android

#### First time setup

First time you want to create a production .apk, do the following steps. By doing this you will be able to generate a release version of the APK, [sign it and zipalign it](http://developer.android.com/tools/publishing/app-signing.html) using just **one** command.

!!!UTDATERT!!!

1. `cd PROJECT_ROOT/platforms/android`

2.  `touch ant.properties`

3.  Open the newly created **ant.properties** and add the following lines:

   - `key.store=/PATH/TO/KEYSTORE`

   - `key.alias=instabart`

#### Normal rutine

1. Open `config.xml` and increment the **versionName** and **versionCode**

2. `git add config.xml && git commit -m "Something smart"`

3. Delete the `node_modules` folder from www. By doing this you reduce the app file size by approx. 20 MB.

4. `cordova build android --release`

5. Restore the `node_modules` folder

This will create a **Instabart-release.apk** file in the folder **platforms/android/ant-build**. We're done!

### iOS

#### First time setup

1. Install dependencies `sudo npm install -g ios-deploy` and

`sudo npm install -g ios-sim`

2. Click on `Instabart.xcodeproj` to open the project in Xcode

3. Select "Team" under General -> Identity ->

Team -> Morten V Noddeland ([email protected])

4. Set "Code Signing under Build settings -> Code Signing -> Release -> "iPhone Distribution: Morten V Noddeland"

#### Normal rutine

1. Open `config.xml` and increment the **versionName** and **versionCode**

2. `git add config.xml && git commit -m "Something smart"`

3. Delete the `node_modules` folder from www. By doing this you reduce the app file size by approx. 20 MB.

4. Open project in Xcode, then click Product -> Archive

5. Restore the `node_modules` folder