Skip to content

Latest commit

 

History

History
149 lines (99 loc) · 4.33 KB

android.md

File metadata and controls

149 lines (99 loc) · 4.33 KB
Raw

Android

Exporting for Android: https://docs.godotengine.org/en/stable/getting_started/workflow/export/exporting_for_android.html#doc-exporting-for-android

  • configure to build with gradle, and install the build template: Project > Install android build template. It will generate a root android folder.

permissions

To use HTTP calls to your backend you need to add the following permissions to your android template in export_presets.cfg:

permissions/internet=true

Otherwise, network communication of any kind will be blocked by the Android OS. (from this warning in the docs)

debug key

generate debug key for godot:

> keytool -keyalg RSA -genkeypair -v -alias YOUR_ALIAS -keystore android.debug.keystore -validity 9999 -deststoretype pkcs12 -keypass YOUR_PASSWORD

replace in the preset options:

keystore/debug_user="YOUR_ALIAS"
keystore/debug_password="YOUR_PASSWORD"

icons

In assets/android you'll find the adaptive icons template from https://cyrilmottier.com/2017/07/06/adaptive-icon-template/

apk for debug

build apk from cli

> /Applications/Apps/Godot.app/Contents/MacOS/Godot --export-debug "Android Debug" --headless

manifest from apk

> aapt dump badging _build/android/lockeyland.apk
> which aapt
aapt: aliased to ~/Library/Android/sdk/build-tools/32.0.0/aapt2

aab for releases

build aab from cli

> /Applications/Apps/Godot.app/Contents/MacOS/Godot --export-debug "Android Release" --headless

manifest from aab

> brew install bundletool
> bundletool dump manifest --bundle _build/android/lockeyland.aab --xpath /manifest/@android:versionName
1.0.0
> bundletool dump manifest --bundle _build/android/lockeyland.aab --xpath /manifest/@android:versionCode
10000

install playstore on emulators

all steps: https://proandroiddev.com/install-google-play-store-in-an-android-emulator-82cd183fefed

1 - download Phonesky.apk 2 - emulator @pixel-api-21 -writable-system 3 - adb remount 4 - adb push ~/path/to/Phonesky.apk /system/priv-app/ 5 - adb shell stop && adb shell start

intall apk on emulator

1 - emulator @pixel-api-21 -no-snapshot -writable-system 2 - fox export an android debug preset 3 - adb uninstall com.uralys.xxx 4 - adb install -r ~/path/to/your.apk 5 - adb logcat -s godot

--> repeat from 2 to 5 on every test

IAP

setting up android plugins

  • To keep your plugins whenever you update (and erase the android folder), you can install them next to your game folder, and symlink to the android/plugins folder each time you reinstall the latest android template.

  • install android plugins next to /fox and /yourgame

for example in my case:

~/Projects/uralys/gamedev/
└── fox
└── yourgame
└── godot.android-plugins
  ├── GodotGooglePlayBilling.x.x.x.release.aar
  └── GodotGooglePlayBilling.gdap
> ln -s ~/Projects/uralys/gamedev/godot.android-plugins android/plugins
> ln -s ~/Projects/uralys/gamedev/godot.addons addons

note: currently using godot-lib.4.1.3.stable.template_release.aar and building assembleRelease from Android Studio

testing IAP

to test android IAP:

  • fox export > select an android release preset to generate the .aab
  • create an intern release
  • add a product
  • add a tester and send invite link to internal Play Store
  • connect to PlayStore with this tester account
  • Accept the invitation through the link

then the test account can see the SKU even from debug.apk generated with fox export > android debug preset manually installed with adb.

API reference and examples: https://docs.godotengine.org/en/stable/tutorials/platform/android/android_in_app_purchases.html

Notifications:

When Fox initializes, it will check if the app useNotifications. If so, it will instantiate a NotificationScheduler singleton and add it to the root node.

To generate an icon, you may use tools like https://romannurik.github.io/AndroidAssetStudio/

The generated icons should be placed in the android/build/res/drawable* folders.