{"id":20332293,"url":"https://github.com/wavemaker/wm-cordova-cli","last_synced_at":"2025-10-29T23:50:12.331Z","repository":{"id":42722918,"uuid":"285268154","full_name":"wavemaker/wm-cordova-cli","owner":"wavemaker","description":"cli to easily build WaveMaker Mobile projects","archived":false,"fork":false,"pushed_at":"2024-08-09T03:58:41.000Z","size":720,"stargazers_count":3,"open_issues_count":10,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-11T21:38:03.771Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wavemaker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-05T11:27:59.000Z","updated_at":"2024-08-09T03:58:44.000Z","dependencies_parsed_at":"2024-08-09T04:47:47.903Z","dependency_job_id":"de9692a1-32ae-4e64-ac41-bd4d5e13e60c","html_url":"https://github.com/wavemaker/wm-cordova-cli","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/wavemaker/wm-cordova-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wavemaker%2Fwm-cordova-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wavemaker%2Fwm-cordova-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wavemaker%2Fwm-cordova-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wavemaker%2Fwm-cordova-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wavemaker","download_url":"https://codeload.github.com/wavemaker/wm-cordova-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wavemaker%2Fwm-cordova-cli/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267779979,"owners_count":24143200,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-14T20:25:53.274Z","updated_at":"2025-10-29T23:50:12.230Z","avatar_url":"https://github.com/wavemaker.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# wm-cordova-cli\n\nA command line untility to build mobile apps created using WaveMaker product.\n\nThe main goal of wm-cordova-cli is to simplify generation of APK or IPA for WaveMaker developers. ```wm-cordova-cli``` combines multiple cordova commands into a single command. First, one has to make sure all the required hardware and software are available and installed. Then execute the command with the appropriate values for arguments.\n\n## ANDROID build\n\n### Requirements\n\n-   Linux or MAC or Windows   \n-   Latest Android Studio    \n-   Node 18.x ([https://nodejs.org/en/blog/release/v10.18.0/](https://nodejs.org/en/download/))    \n-   GIT ([https://git-scm.com/download](https://git-scm.com/download))    \n-   Java 17 (for Wavemaker 11.2 and WaveMaker 10.16 projects) or Java 8 for earlier versions     \n-   Gradle 8.7 ([https://gradle.org/releases/](https://gradle.org/releases/))    \n-   KeyStore file for production release builds ([https://developer.android.com/studio/publish/app-signing#generate-key](https://developer.android.com/studio/publish/app-signing#generate-key))    \n-   Install wm-cordova-cli (npm install -g @wavemaker/wm-cordova-cli)    \n-   Make sure JAVA_HOME, ANDROID_SDK and GRADLE_HOME are set in the environment variables and also in PATH.\n-   For development build, keystore is optional.\n-   For production build, keystore is required.\n  \n\n### Command\n\nwm-cordova build android \u003csrc_dir\u003e \u003cdest_dir\u003e [additional_arguments]\n\n  \n  \n\n\n|\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;**Argument**\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;| **Description** |\n|--|--|\n| **src_dir** | **DEFAULT:** current working directory.\u003cbr\u003e Path to the cordova zip (or) path to the cordova project folder. |\n|**dest_dir**|**OPTIONAL:** Path to the directory where all build files are to be kept.|\n|**\\-\\-cordovaVersion**|**OPTIONAL:** Cordova cli version to use|\n|**\\-\\-cordovaAndroidVersion**|**OPTIONAL:** Version of cordova-ios to use|\n|**\\-\\-aKeyStore**|Absolute path of the key store. If keystore is not given then android debug key is used.|\n|**\\-\\-aStorePassword**|Password to key store|\n|**\\-\\-aKeyAlias**|Alias name of the key|\n|**\\-\\-aKeyPassword**|Key Password|\n|**\\-\\-packageType**|**DEFAULT:** apk\u003cbr\u003e'apk' or 'bundle' (for aab)\n|**\\-\\-buildType**|**DEFAULT:** development\u003cbr\u003edevelopment or production\u003cbr\u003eUse ‘production’ with keystore specified.|\n|**\\-\\-allowHooks**|**DEFAULT:** true \u003cbr\u003e this flag can be used to turn on and off cordova hooks functionality.|\n\n  \n\n### Example 1\n\n~~~\nwm-cordova build android \"/path/to/src\"\n~~~\n### Example 2    \n~~~\nwm-cordova build android \"/path/to/src\" \\\n--aKeyStore=\"/path/to/file.keystore\" \\\n--aStorePassword=\"store_password\" \\\n--aKeyAlias=\"key_alias_name\" \\\n--aKeyPassword=\"key\" \\\n--buildType=\"production\"\n~~~\n\n## IOS build\n\n### Requirements\n\n-   MAC machine    \n-   Latest XCODE\n-   CocoaPods ([https://guides.cocoapods.org/using/getting-started.html#toc_3](https://guides.cocoapods.org/using/getting-started.html#toc_3))    \n-   Node 18.x ([https://nodejs.org/en/blog/release/v10.18.0/](https://nodejs.org/en/download/))    \n-   GIT ([https://git-scm.com/download/mac](https://git-scm.com/download/mac))    \n-   Apple developer or distribution P12 certificates    \n-   Provisioning profile\n-   Install wm-cordova-cli (npm install -g @wavemaker/wm-cordova-cli)\n-   For development build, development certificate and development provisioning file are required.\n-   For production build, distribution certificate and distribution provisioning file are required.\n\n**NOTE:** Before building an app, please make sure that neither iPhone nor iPad is not connected to Mac. This is open [issue](https://github.com/apache/cordova-ios/issues/420) on cordova-ios.\n\n### Command\n\nwm-cordova build ios \u003csrc_dir\u003e \u003cdest_dir\u003e [additional_arguments]\n\n  \n  \n|\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;**Argument**\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;| **Description** |\n|--|--|\n| **src_dir** | **DEFAULT:** current working directory.\u003cbr\u003e Path to the cordova zip (or) path to the cordova project folder. |\n|**dest_dir**|**OPTIONAL:** Path to the directory where all build files are to be kept.|\n|**\\-\\-cordovaVersion**|**OPTIONAL:** Cordova cli version to use|\n|**\\-\\-cordovaIosVersion**|**OPTIONAL:**  Version of cordova-ios to use|\n|**\\-\\-iCertificate**|Absolute path of P12 certificate location|\n|**\\-\\-iCertificatePassword**|Password to unlock the certificate.|\n|**\\-\\-iProvisioningFile**|Absolute path of provisioning file|\n|**\\-\\-buildType**|**DEFAULT:** development\u003cbR\u003edevelopment or production \u003cbr\u003eUse ‘production’ with an AppStore distribution certificate.|\n|**\\-\\-allowHooks**|**DEFAULT:** true \u003cbr\u003e this flag can be used to turn on and off cordova hooks functionality.|\n\n\n### Example\n\n  \n~~~\nwm-cordova build ios \"/path/to/src\" \\\n--iCertificate=\"/path/to/distribution.p12\" \\\n--iCertificatePassword=\"unlock_password\" \\\n--iProvisioningFile=\"/path/to/profile.mobileprovision\" \\\n--buildType=\"production\"\n~~~\n\n\n## Cordova versions used for a build \n1. Based upon the value of 'phonegap-cli' preference value, versions mentioned in the below table are used by default.\n\n| PHONEGAP-CLI | CORDOVA | CORDOVA-ANDROID | CORDOVA-IOS |\n|--|--|--|--|\n| cli-9.0.0 | 9.0.0 | 8.0.0 | 5.1.1 |\n| cli-8.1.1 | 8.1.1 | 7.1.2 | 4.5.5 |\n| cli-8.0.0 | 8.0.0 | 7.0.0 | 4.5.4 |\n\n2. In config.xml, the above cordova values can be overridden by setting preferences with the below mentioned names.\n\n    wm-cordova\u003cbr\u003e\n    wm-cordova-android\u003cbr\u003e\n    wm-cordova-ios\n\n3. Cordova versions can also be mentioned as command line arguments.\n\n## Additional Information\n\n1. Destination folder path is logged at the start of the build.\n2. Build log files are present at \u003cdestination_folder\u003e/output/logs\n3. The artifact built is available at \u003cdestination_folder\u003e/output/\u003cplatform_type\u003e/. The complete path is printed in log also.\n\n## License\nMIT License\nCopyright (c)  2020  WaveMaker\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwavemaker%2Fwm-cordova-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwavemaker%2Fwm-cordova-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwavemaker%2Fwm-cordova-cli/lists"}