From d29213189be24b38eb6c28b991fcff7ce4b83adf Mon Sep 17 00:00:00 2001 From: Celso Wellington Date: Sat, 18 Jul 2020 06:39:10 -0300 Subject: [PATCH 1/4] Updated Android Environment setup PR regarding issue #1610 Added a quick guide on how to upgrade the project Gradle version to avoid errors when using the lastest version of JDK. Updated the Android Studio installation guide. --- docs/getting-started.md | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/docs/getting-started.md b/docs/getting-started.md index b2834479793..bc54defed16 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -163,7 +163,7 @@ If you have already installed Node on your system, make sure it is Node 8.3 or n We recommend installing JDK using [Homebrew](http://brew.sh/). Run the following commands in a Terminal after installing Homebrew: ```sh -brew cask install adoptopenjdk/openjdk/adoptopenjdk8 +brew cask install adoptopenjdk/openjdk/adoptopenjdk14 ``` If you have already installed JDK on your system, make sure it is JDK 8 or newer. @@ -176,22 +176,29 @@ Follow the [installation instructions for your Linux distribution](https://nodej -

Node, Python2, JDK

+

Node, Python, JDK

-We recommend installing Node and Python2 via [Chocolatey](https://chocolatey.org), a popular package manager for Windows. +We recommend installing Node and Python via [Chocolatey](https://chocolatey.org), a popular package manager for Windows. -React Native also requires a recent version of the [Java SE Development Kit (JDK)](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html), as well as Python 2. Both can be installed using Chocolatey. +React Native also requires a recent version of the [Java SE Development Kit (JDK)](https://openjdk.java.net/projects/jdk/14/), as well as Python. Both can be installed using Chocolatey. Open an Administrator Command Prompt (right click Command Prompt and select "Run as Administrator"), then run the following command: ```powershell -choco install -y nodejs.install python2 jdk8 +choco install -y nodejs.install python openjdk ``` If you have already installed Node on your system, make sure it is Node 8.3 or newer. If you already have a JDK on your system, make sure it is version 8 or newer. > You can find additional installation options on [Node's Downloads page](https://nodejs.org/en/download/). +### Important: + +If you're using the latest version of JDK, you'll need to change the Gradle version of your project so it can recognize the JDK. +You can do that by going to `{project root folder}\android\gradle\wrapper\gradle-wrapper.properties` and change the `distributionUrl` value to upgrade the Gradle version. You can check out [here the lastest releases of Gradle](https://gradle.org/releases/). + + +

Xcode & CocoaPods

@@ -226,7 +233,7 @@ For more information, please visit [CocoaPods Getting Started guide](https://gui

Java Development Kit

-React Native requires version 8 of the Java SE Development Kit (JDK). You may download and install [OpenJDK](http://openjdk.java.net) from [AdoptOpenJDK](https://adoptopenjdk.net/) or your system packager. You may also [Download and install Oracle JDK 8](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) if desired. +React Native requires at least the version 8 of the Java SE Development Kit (JDK). You may download and install [OpenJDK](http://openjdk.java.net) from [AdoptOpenJDK](https://adoptopenjdk.net/) or your system packager. You may also [Download and install Oracle JDK 14](https://openjdk.java.net/projects/jdk/14/) if desired. @@ -238,7 +245,7 @@ Setting up your development environment can be somewhat tedious if you're new to

1. Install Android Studio

-[Download and install Android Studio](https://developer.android.com/studio/index.html). Choose a "Custom" setup when prompted to select an installation type. Make sure the boxes next to all of the following are checked: +[Download and install Android Studio](https://developer.android.com/studio/index.html). Through the Android Studio Installation Wizard, make sure to check these itens to be installed: @@ -265,7 +272,7 @@ Once setup has finalized and you're presented with the Welcome screen, proceed t Android Studio installs the latest Android SDK by default. Building a React Native app with native code, however, requires the `Android 10 (Q)` SDK in particular. Additional Android SDKs can be installed through the SDK Manager in Android Studio. -The SDK Manager can be accessed from the "Welcome to Android Studio" screen. Click on "Configure", then select "SDK Manager". +To do that, open Android Studio, click on "Configure" button and select "SDK Manager". From 247a56590191d69eb3638385b0032a5b3797d72d Mon Sep 17 00:00:00 2001 From: Celso Wellington Date: Sun, 19 Jul 2020 08:10:43 -0300 Subject: [PATCH 2/4] Reverted Python and JDK version change, edited tips Reverted JDK suggestions to version 8, added '>' before the Gradle upgrade tip, fixed a sentence regarding Android Studio installation, added a tip regarding build tools that have compatibility with Python3 versions. --- docs/getting-started.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/getting-started.md b/docs/getting-started.md index bc54defed16..07f0748d42f 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -163,7 +163,7 @@ If you have already installed Node on your system, make sure it is Node 8.3 or n We recommend installing JDK using [Homebrew](http://brew.sh/). Run the following commands in a Terminal after installing Homebrew: ```sh -brew cask install adoptopenjdk/openjdk/adoptopenjdk14 +brew cask install adoptopenjdk/openjdk/adoptopenjdk8 ``` If you have already installed JDK on your system, make sure it is JDK 8 or newer. @@ -176,26 +176,26 @@ Follow the [installation instructions for your Linux distribution](https://nodej -

Node, Python, JDK

+

Node, Python2, JDK

-We recommend installing Node and Python via [Chocolatey](https://chocolatey.org), a popular package manager for Windows. +We recommend installing Node and Python2 via [Chocolatey](https://chocolatey.org), a popular package manager for Windows. -React Native also requires a recent version of the [Java SE Development Kit (JDK)](https://openjdk.java.net/projects/jdk/14/), as well as Python. Both can be installed using Chocolatey. +React Native also requires [Java SE Development Kit (JDK)](https://openjdk.java.net/projects/jdk8/), as well as Python2. Both can be installed using Chocolatey. + +> Some build tools have compability with some Python3 versions. Open an Administrator Command Prompt (right click Command Prompt and select "Run as Administrator"), then run the following command: ```powershell -choco install -y nodejs.install python openjdk +choco install -y nodejs.install python2 openjdk8 ``` If you have already installed Node on your system, make sure it is Node 8.3 or newer. If you already have a JDK on your system, make sure it is version 8 or newer. > You can find additional installation options on [Node's Downloads page](https://nodejs.org/en/download/). -### Important: -If you're using the latest version of JDK, you'll need to change the Gradle version of your project so it can recognize the JDK. -You can do that by going to `{project root folder}\android\gradle\wrapper\gradle-wrapper.properties` and change the `distributionUrl` value to upgrade the Gradle version. You can check out [here the lastest releases of Gradle](https://gradle.org/releases/). +> If you're using the latest version of Java Development Kit, you'll need to change the Gradle version of your project so it can recognize the JDK. You can do that by going to `{project root folder}\android\gradle\wrapper\gradle-wrapper.properties` and changing the `distributionUrl` value to upgrade the Gradle version. You can check out [here the lastest releases of Gradle](https://gradle.org/releases/). @@ -245,7 +245,7 @@ Setting up your development environment can be somewhat tedious if you're new to

1. Install Android Studio

-[Download and install Android Studio](https://developer.android.com/studio/index.html). Through the Android Studio Installation Wizard, make sure to check these itens to be installed: +[Download and install Android Studio](https://developer.android.com/studio/index.html). While on Android Studio intallation wizard, make sure the boxes next to all of the following items are checked: From 03b96136f9b3d79831cf499ad1c3e14e020bfab1 Mon Sep 17 00:00:00 2001 From: Celso Wellington Date: Wed, 22 Jul 2020 17:22:22 -0300 Subject: [PATCH 3/4] Removing Python3 tip --- docs/getting-started.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/getting-started.md b/docs/getting-started.md index 07f0748d42f..70f5066289e 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -182,8 +182,6 @@ We recommend installing Node and Python2 via [Chocolatey](https://chocolatey.org React Native also requires [Java SE Development Kit (JDK)](https://openjdk.java.net/projects/jdk8/), as well as Python2. Both can be installed using Chocolatey. -> Some build tools have compability with some Python3 versions. - Open an Administrator Command Prompt (right click Command Prompt and select "Run as Administrator"), then run the following command: ```powershell From 1343f8f8fd8b324b0d8efb78eeedd5d22d9452ba Mon Sep 17 00:00:00 2001 From: Bartosz Kaszubowski Date: Fri, 24 Jul 2020 21:47:47 +0200 Subject: [PATCH 4/4] fix Oracle JDK link --- docs/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started.md b/docs/getting-started.md index 70f5066289e..d9899b7ba74 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -231,7 +231,7 @@ For more information, please visit [CocoaPods Getting Started guide](https://gui

Java Development Kit

-React Native requires at least the version 8 of the Java SE Development Kit (JDK). You may download and install [OpenJDK](http://openjdk.java.net) from [AdoptOpenJDK](https://adoptopenjdk.net/) or your system packager. You may also [Download and install Oracle JDK 14](https://openjdk.java.net/projects/jdk/14/) if desired. +React Native requires at least the version 8 of the Java SE Development Kit (JDK). You may download and install [OpenJDK](http://openjdk.java.net) from [AdoptOpenJDK](https://adoptopenjdk.net/) or your system packager. You may also [Download and install Oracle JDK 14](https://www.oracle.com/java/technologies/javase-jdk14-downloads.html) if desired.