Skip to content

Commit 0f08990

Browse files
committed
Added update notification and added documentation
1 parent 0bccb7b commit 0f08990

5 files changed

Lines changed: 566 additions & 58 deletions

File tree

README.md

Lines changed: 43 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -4,49 +4,21 @@ A command line untility to build mobile apps created using WaveMaker product.
44

55
The 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
142132
MIT License
143133
Copyright (c) 2020 WaveMaker

index.js

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,7 @@
11
#!/usr/bin/env node
2+
const updateNotifier = require('update-notifier');
3+
const pkg = require('./package.json');
4+
updateNotifier({pkg}).notify();
25
const {
36
build
47
} = require('./src/command');

0 commit comments

Comments
 (0)