Skip to content

Commit fda413e

Browse files
gregveresrstoenescu
authored andcommitted
new instructions for windows users (quasarframework#5973)
The instructions for windows users were not correct given the state of things in December 2019. In addition to the software listed on this page to install, I had to install the JDK separately and gradle separately. And Cordova has moved on and now requires android-28 SDK to be installed or it wont work. I have followed the new instructions in this PR and tested that it worked properly. I pass the cordova requirements check.
1 parent 6f2e869 commit fda413e

File tree

1 file changed

+14
-2
lines changed

1 file changed

+14
-2
lines changed

docs/src/pages/quasar-cli/developing-cordova-apps/preparation.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,18 +30,30 @@ PATH=$PATH:$ANDROID_HOME/tools; PATH=$PATH:$ANDROID_HOME/platform-tools
3030
3131
#### Windows
3232

33+
After installing Android Studio, you need to install two more pieces of software:
34+
* JDK from Oracle. It can be found [here](https://www.oracle.com/java/technologies/jdk8-downloads.html)
35+
* Gradle. It used to usable from Android Studio but now you have to install it separately. There is a very specific version that cordova requires. You can download it [here](https://downloads.gradle-dn.com/distributions/gradle-4.10.3-all.zip)
36+
37+
Then you will have to set environment variables. You will need to set the following variables. Cordova has a good guide for it already. It can be found [here](https://cordova.apache.org/docs/en/latest/guide/platforms/android/#setting-environment-variables). You need to:
38+
* add ANDRIOD_HOME. It can safely be set to: "%USERPROFILE%\AppData\Local\Android\Sdk"
39+
* add two ANDROID_HOME directories to your path: %ANDROID_HOME%\tools;%ANDROID_HOME%\platform-tools
40+
* add Gradle to your path. Note that gradle does not have an installer. You just put the binary files where you want them, then add the bin directory to your path.
41+
42+
If you have an init script for your command prompt or powershell, you can try this:
3343
```bash
3444
setx ANDROID_HOME "%USERPROFILE%\AppData\Local\Android\Sdk"
35-
setx path "%path%;%ANDROID_HOME%\tools;%ANDROID_HOME%\platform-tools"
45+
setx path "%path%;%ANDROID_HOME%\tools;%ANDROID_HOME%\platform-tools;<gradle_path>\bin;"
3646
```
3747

48+
After the tools are installed, setup Android Studio with the correct SDK and create a virtual machine.
49+
3850
* Start Android studio by changing into the folder you installed it in and run `./studio.sh`. Next step is to install the individual SDKs:
3951

4052
* Open the "Configure" menu at the bottom of the window:
4153

4254
![SDK manager](https://cdn.quasar.dev/img/Android-Studio-SDK-Menu.png "SDK manager")
4355

44-
* Select the desired SDKs. As per August 2018 Cordova supports 5.0 and up and click on "Apply" to install the SDKs.
56+
* Select the desired SDKs. As per December 2019 Cordova requires android-28 (Android 9.0 - Pie) so be sure to include it. Click on "Apply" to install the SDKs.
4557

4658
![SDK selection](https://cdn.quasar.dev/img/Android-Studio-SDK-selection.png "SDK selection")
4759

0 commit comments

Comments
 (0)