@@ -4,49 +4,21 @@ A command line untility to build mobile apps created using WaveMaker product.
44
55The 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.
66
7-
8- ### Cordova versions used for a build
9- 1 . Based upon the value of 'phonegap-cli' preference value, versions mentioned in the below table are used by default.
10-
11- | PHONEGAP-CLI | CORDOVA | CORDOVA-ANDROID | CORDOVA-IOS |
12- | --| --| --| --|
13- | cli-9.0.0 | 9.0.0 | 8.0.0 | 5.1.1 |
14- | cli-8.1.1 | 8.1.1 | 7.1.2 | 4.5.5 |
15- | cli-8.0.0 | 8.0.0 | 7.0.0 | 4.5.4 |
16-
17- 2 . In config.xml, the above cordova values can be overridden by setting preferences with the below mentioned names.
18-
19- wm-cordova<br >
20- wm-cordova-android<br >
21- wm-cordova-ios
22-
23- 3 . Cordova versions can also be mentioned as command line arguments.
24-
25-
26-
277## ANDROID build
288
299### Requirements
3010
31- - Linux or MAC
32-
33- - Latest Android Studio
34-
35- - Node 10.x ([ https://nodejs.org/en/blog/release/v10.18.0/ ] ( https://nodejs.org/en/download/ ) )
36-
37- - GIT ([ https://git-scm.com/download/mac ] ( https://git-scm.com/download/mac ) )
38-
39- - Java 8
40-
41- - Gradle 6
42-
43- - KeyStore file for production release builds
44-
45- - Install wm-cordova-cli (npm install -g @wavemaker/wm-cordova-cli )
46-
11+ - Linux or MAC
12+ - Latest Android Studio
13+ - Node 10.x ([ https://nodejs.org/en/blog/release/v10.18.0/ ] ( https://nodejs.org/en/download/ ) )
14+ - GIT ([ https://git-scm.com/download/mac ] ( https://git-scm.com/download/mac ) )
15+ - Java 8
16+ - Gradle 6 ([ https://gradle.org/releases/ ] ( https://gradle.org/releases/ ) )
17+ - 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 ) )
18+ - Install wm-cordova-cli (npm install -g @wavemaker/wm-cordova-cli )
4719- Make sure JAVA_HOME, ANDROID_SDK and GRADLE_HOME are set in the environment variables and also in PATH.
48-
49-
20+ - For development build, keystore is optional.
21+ - For production build, keystore is required.
5022
5123
5224### Command
@@ -63,7 +35,7 @@ wm-cordova build android <src_dir> <dest_dir> [additional_arguments]
6335| ** dest_dir** | ** OPTIONAL:** Path to the directory where all build files are to be kept.|
6436| ** \-\- cordovaVersion** | ** OPTIONAL:** Cordova cli version to use|
6537| ** \-\- cordovaAndroidVersion** | ** OPTIONAL:** Version of cordova-ios to use|
66- | ** \-\- aKeyStore** | Absolute path of the key store. If keystore is not given the, android debug is used.|
38+ | ** \-\- aKeyStore** | Absolute path of the key store. If keystore is not given then android debug key is used.|
6739| ** \-\- aStorePassword** | Password to key store|
6840| ** \-\- aKeyAlias** | Alias name of the key|
6941| ** \-\- aKeyPassword** | Key Password|
@@ -90,22 +62,16 @@ wm-cordova build android "/path/to/src" \
9062
9163### Requirements
9264
93- - MAC machine
94-
65+ - MAC machine
9566- Latest XCODE
96-
97- - CocoaPods ([ https://guides.cocoapods.org/using/getting-started.html#toc_3 ] ( https://guides.cocoapods.org/using/getting-started.html#toc_3 ) )
98-
99- - Node 10.x ([ https://nodejs.org/en/blog/release/v10.18.0/ ] ( https://nodejs.org/en/download/ ) )
100-
101- - GIT ([ https://git-scm.com/download/mac ] ( https://git-scm.com/download/mac ) )
102-
103- - Apple developer or distribution P12 certificates
104-
105- - Provisioning profile
106-
67+ - CocoaPods ([ https://guides.cocoapods.org/using/getting-started.html#toc_3 ] ( https://guides.cocoapods.org/using/getting-started.html#toc_3 ) )
68+ - Node 10.x ([ https://nodejs.org/en/blog/release/v10.18.0/ ] ( https://nodejs.org/en/download/ ) )
69+ - GIT ([ https://git-scm.com/download/mac ] ( https://git-scm.com/download/mac ) )
70+ - Apple developer or distribution P12 certificates
71+ - Provisioning profile
10772- Install wm-cordova-cli (npm install -g @wavemaker/wm-cordova-cli )
108-
73+ - For development build, development certificate and development provisioning file are required.
74+ - For production build, distribution certificate and distribution provisioning file are required.
10975
11076
11177
@@ -138,6 +104,30 @@ wm-cordova build ios "/path/to/src" \
138104--packageType="production"
139105~~~
140106
107+
108+ ## Cordova versions used for a build
109+ 1 . Based upon the value of 'phonegap-cli' preference value, versions mentioned in the below table are used by default.
110+
111+ | PHONEGAP-CLI | CORDOVA | CORDOVA-ANDROID | CORDOVA-IOS |
112+ | --| --| --| --|
113+ | cli-9.0.0 | 9.0.0 | 8.0.0 | 5.1.1 |
114+ | cli-8.1.1 | 8.1.1 | 7.1.2 | 4.5.5 |
115+ | cli-8.0.0 | 8.0.0 | 7.0.0 | 4.5.4 |
116+
117+ 2 . In config.xml, the above cordova values can be overridden by setting preferences with the below mentioned names.
118+
119+ wm-cordova<br >
120+ wm-cordova-android<br >
121+ wm-cordova-ios
122+
123+ 3 . Cordova versions can also be mentioned as command line arguments.
124+
125+ ## Additional Information
126+
127+ 1 . Destination folder path is logged at the start of the build.
128+ 2 . Build log files are present at <destination_folder>/output/logs
129+ 3 . The artifact built is available at <destination_folder>/output/<platform_type>/. The complete path is printed in log also.
130+
141131## License
142132MIT License
143133Copyright (c) 2020 WaveMaker
0 commit comments