Skip to content

Latest commit

 

History

History
131 lines (95 loc) · 3.45 KB

CONTRIBUTING.md

File metadata and controls

131 lines (95 loc) · 3.45 KB

How to Contribute

Get the Source

$ git clone https://github.com/phonegap/phonegap-app-developer.git
$ cd phonegap-app-developer/

Join the Discussion

We use the GitHub Issue Tracker for all of our discussions. You can filter the discussions with the discussion label.

Submit an Issue

We use the GitHub Issue Tracker for all of our issues.

Commits

We expect atomic commits that reference the GitHub issue.

For example:

  • [#33] Fix viewport layout.
  • [#144] Add PointerEvent support for WP8.

When no issue is exists, then prefix each commit with the root directory or topic:

  • [doc] Update date in LICENSE.
  • [www] Fix button style.
  • [ios] Update icon name in plist.

Tags

When a tag affects all platforms, use an ordinary semver tag:

  • 0.0.1
  • 0.1.0
  • 0.1.1
  • 0.2.0
  • 1.0.0

Platform releases should individually tagged as:

  • 1.0.0-android-rc.1
  • 1.0.0-android-release
  • 1.0.0-ios-release

Releases

Update CHANGELOG

Replace 1.0.0 with the previous version:

$ git log HEAD...1.0.0 --format="%s"

Copy and paste the output to CHANGELOG.md

iOS Release Build

  • $ cordova build ios
  • Build and test the app on a device
  • Project -> Archive
  • Window -> Organizer -> Archive
  • Select the latest archive with the correct version
  • Select Distribute -> Ad Hoc -> Select AppStore Adobe Systems provisioning profile
  • Export to res/release/ios/PhoneGap-x.x.x-appstore.ipa

iOS Submission

  • itunesconnect.apple.com
  • Add a new PhoneGap Developer version
    • Choose to not auto-release the app
  • Download Application Loader
  • Open Application Loader
  • Select Deliver Your App
  • Select PhoneGap with the correct version number
  • Select Choose
  • Select Send

Android Release Build

  • clone phonegap-app-developer-keys
  • cd phonegap-app-developer/
  • ln -s path/to/phonegap-app-developer-keys/keys/android resources/signing/android
  • $ cordova build android --release
  • cp platforms/android/ant-build/PhoneGap-release.apk resources/release/android/PhoneGap-x.x.x-release.apk

Windows Phone Release Build

  • cd phonegap-app-developer/
  • cordova build wp8 --release
  • cp platforms/wp8/Bin/Release/com.adobe.phonegap.app.xap resources/release/wp8/phonegap-x.x.x.xap

or

  • cd phonegap-app-developer/
  • cordova build wp8 # to populate the native code
  • Update WMAppManifest.xml
  • open platforms/wp8/PhoneGap.sln
  • Select "Release"
  • Select from menu Build -> Build Solution
  • cp platforms/wp8/Bin/Release/com.adobe.phonegap.app.xap resources/release/wp8/phonegap-x.x.x.xap

Windows Phone Submission

  • Update test.app.phonegap.com to use the latest connect-phonegap

  • Deploy the site

  • Open Microsoft Remote Desktop

  • Go to dev.windowsphone.com

  • Select Dashboard

  • Select Windows Phone Store

  • Select Apps

  • Select PhoneGap Developer

  • Select Update App

  • Select Upload and Describe Your Package

  • Go to GitHub and download the latest tagged release and extract it

  • Select Replace on Windows Phone site

  • Update the package version number

  • Update the change log (involves replacing the current content)

  • Save

  • Press Review and Submit

  • Verify that it's a manual publish

  • Press Submit

  • Clean up the downloaded GitHub zip file