build-tools

Status

We have two sets of scripts. The bash scripts are the original ones and have been run on multiple versions. But they only work on OSX/Linux. The JS scripts are new and we are in the process of migrating to them.

When building a distribution for downstream consumption:

Bash Scripts Execution

The examples below will be for the case of "3.4.0esr".

Note: [all] works on all releases

Note: [creation] versus [update] indicates which steps are applicable for initial creation of an esr branch, versus making an update to an esr branch. If neither of these notations are present, then the step applies to all circumstances.

1. Create your own corimf-settings from the sample provided. Determine if cordova-lib should be in OTHER_REPOS (>=3.4.x)
2. [creation] Edit config.json to add the versions of each plugin and tool for this new esr release.
3. [all] Optional: run corimf-setup for initial setup a new workspace with new repos.
4. Run corimf-cron to verify that the cron job syncing git-wip-us.a.o with github.com/apache is running well.
5. Run corimf-catchup-apache to get your local repos and corimf up-to-date with the content and tags from the Apache repos. Run it with BASE_BRANCH=master if you are preparing to create a new ESR branch, or run it with BASE_BRANCH=3.4.x if you already have your 3.4.0esr branch. Though you may think this needs to get run only when creating a new esr branch, it also comes in handy when you want to cherry-pick from master.
6. [update] Run corimf-catchup to get your local repos up-to-date from corimf, if more than one person is contributing to a single fix.
7. [creation] Run corimf-newver to create a new ESR branch from an existing Apache branch and put it on corimf. Set BASE_BRANCH=3.4.x before running.
8. [update] Make your changes to the ESR branch, commit them and push them to corimf.
9. [all] [update] Run corimf-check to sanity check everything. This needs to be run in the git repo that you updated ( for example 'cordova-ios').
10. [all] Run corimf-show-plugin-versions to verify that the present versions of the plugins are what is desired (match what the platforms were tested against by the community)
11. [all] [update] Run corimf-tag to create a new "u" tag on the branch
12. Run corimf-snapshot to create a zip of each platform source.
    • Make sure the file IBM-RELEASE-NOTES.txt is populated and shows the files that have changed since the previous drop. NOTE: IBM-MODIFICATIONS.txt file does not exist until someone creates it at the first update to the repo
13. For versions before 3.4.0, run the platform build scripts
    • corimf-build-android

JS Scripts Execution

Creating ESR helloworld and mobilespec runtime samples

For the Cordova team, these scripts can be used to create runtime sample projects to post to GSA for other teams to use when debugging issues.

For the integration team and others, these scripts can be used to create both a standalone Cordova application to be used when isolating issues to/from Cordova and a Cordova testing framework app (mobilespec) to quickly verify if there is an issue in Cordova. As an alternative, you can simply download the posted runtime sample projects on GSA.

1. Create your own corimf-settings.js from the sample provided.
   • Set PROJECT_ONLY and MOBILESPEC to true if you only want to get the runtime sample projects.
   • Set BRANCH as the ESR branch you want to build from and NEW_TAG as the latest tag from that ESR branch, which can be found here.
   • Set REMOTE_ORIGIN and BASE_BRANCH according to their description
   • If only building esr runtime projects, no other values need to be changed unless there are special circumstances you are trying to recreate, like skipping a plugin
2. Ensure you have all the repos on your machine at the same level as the build-tools directory and checked out at the latest tag that was specified in the settings file
3. Ensure you have the appropriate environment set up for whatever platform you will be building (Xcode, Android SDK, etc)
4. Run "node build-tools/corimf-build-platform.js" (i.e. node build-tools/corimf-build-ios.js). You will be prompted to confirm that all the settings are correct.
5. Once the script finishes running you will have a directory for the helloworld project (example-platform-tag) and the mobilespec project (mobilespec-platform-tag). Within those, you can use the command './cordova/run' to build and run the projects. Edit the www files as needed to debug an issue.