diff --git a/tutorials/export/exporting_for_android.rst b/tutorials/export/exporting_for_android.rst index a9342887b..d2b9527c8 100644 --- a/tutorials/export/exporting_for_android.rst +++ b/tutorials/export/exporting_for_android.rst @@ -9,24 +9,33 @@ The following steps detail what is needed to setup the SDK and the engine. Download the Android SDK ------------------------ -Download and install the Android SDK from -`developer.android.com `__. +Download and install the Android SDK. -If you install Android Studio, you need to run it once to complete the SDK setup. +- You can install it using `Android Studio `__. + + - Run it once to complete the SDK setup using these `instructions `__. + - Ensure that the `required packages `__ are installed as well. -Install OpenJDK 8 +- You can install it using the `command line tools `__. + + - Once the command line tools are installed, run the `sdkmanager `__ command to complete the setup process: + +:: + + sdkmanager --sdk_root= "platform-tools" "build-tools;30.0.1" "platforms;android-29" "cmdline-tools;latest" + +Install OpenJDK ----------------- -Download and install `OpenJDK 8 `__, -newer versions do not work. +Download and install `OpenJDK `__. Create a debug.keystore ----------------------- Android needs a debug keystore file to install to devices and distribute non-release APKs. If you have used the SDK before and have built -projects, ant or eclipse probably generated one for you (on Linux and -macOS, you can find it in the ``~/.android`` directory). +projects, ant or eclipse probably generated one for you (in the ``~/.android`` directory on Linux and +macOS, in the ``C:\Users\\.android\`` directory on Windows). If you can't find it or need to generate one, the keytool command from the JDK can be used for this purpose:: @@ -35,13 +44,6 @@ the JDK can be used for this purpose:: This will create a ``debug.keystore`` file in your current directory. You should move it to a memorable location such as ``%USERPROFILE%\.android\``, because you will need its location in a later step. For more information on ``keytool`` usage, see `this Q&A article `__. -Make sure you have adb ----------------------- - -Android Debug Bridge (``adb``) is the command line tool used to communicate with -Android devices. It's installed with the SDK, but you may need to install one -(any) of the Android API levels for it to be installed in the SDK directory. - Setting it up in Godot ---------------------- @@ -55,13 +57,10 @@ Scroll down to the section where the Android settings are located: .. image:: img/androidsdk.png -In that screen, the path to 3 files needs to be set: +In that screen, 2 paths need to be set: -- The ``adb`` executable (``adb.exe`` on Windows) - - It can usually be found at ``%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe`` on Windows and at ``/Users/$USER/Library/Android/sdk/platform-tools/adb`` on macOS. - -- The ``jarsigner`` executable (from JDK 6 or 8) - - On Windows, OpenJDK installs to a directory like ``%PROGRAMFILES%\AdoptOpenJDK\jdk-8.0.252.09-hotspot\bin``. On Linux and macOS, it typically installs to a directory like ``/usr/bin/jarsigner``. The exact path may vary depending on the OpenJDK update you've installed and your machine's operating system. +- The ``Android Sdk Path`` should be the location where the Android SDK was installed. + - For example ``%LOCALAPPDATA%\Android\Sdk\`` on Windows or ``/Users/$USER/Library/Android/sdk/`` on macOS. - The debug ``.keystore`` file - It can be found in the folder where you put the ``debug.keystore`` file you created above. diff --git a/tutorials/export/img/androidsdk.png b/tutorials/export/img/androidsdk.png index a71d6e7fd..5eb605871 100644 Binary files a/tutorials/export/img/androidsdk.png and b/tutorials/export/img/androidsdk.png differ