exporting_for_android.rst 2.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  1. .. _doc_exporting_for_android:
  2. Exporting for Android
  3. =====================
  4. Exporting for Android has fewer requirements than compiling Godot for it. The
  5. following steps detail what is needed to setup the SDK and the engine.
  6. Download the Android SDK
  7. ------------------------
  8. Download and install the Android SDK from
  9. http://developer.android.com/sdk/index.html
  10. Install OpenJDK or Oracle JDK
  11. -----------------------------
  12. Download and install OpenJDK or Oracle JDK. Version 6 and 8 are known to
  13. work, some users have reported issues with the jarsigner (used to sign the
  14. APKs) in JDK 7.
  15. Create a debug.keystore
  16. -----------------------
  17. Android needs a debug keystore file to install to devices and distribute
  18. non-release APKs. If you have used the SDK before and have built
  19. projects, ant or eclipse probably generated one for you (In Linux and
  20. OSX, you can find it in the ~/.android folder).
  21. If you can't find it or need to generate one, the keytool command from
  22. the JDK can be used for this purpose:
  23. ::
  24. keytool -keyalg RSA -genkeypair -alias androiddebugkey -keypass android -keystore debug.keystore -storepass android -dname "CN=Android Debug,O=Android,C=US" -validity 9999
  25. Make sure you have adb
  26. ----------------------
  27. Android Debug Bridge (adb) is the command line tool used to communicate with
  28. Android devices. It's installed with the SDK, but you may need to install one
  29. (any) of the Android API levels for it to be installed in the SDK directory.
  30. Setting it up in Godot
  31. ----------------------
  32. Enter the Editor Settings screen. This screens contains the editor
  33. settings for the user account in the computer (It's independent from the
  34. project).
  35. .. image:: /img/editorsettings.png
  36. Scroll down to the section where the Android settings are located:
  37. .. image:: /img/androidsdk.png
  38. In that screen, the path to 3 files needs to be set:
  39. - The *adb* executable (adb.exe on Windows)
  40. - The *jarsigner* executable (from JDK 6 or 8)
  41. - The debug *keystore*
  42. Once that is configured, everything is ready to export to Android!