2 Building the Android Port
nutbuster edited this page 2021-07-29 20:38:23 +00:00

Prerequisite Get An actual phone with developer mode enabled (rooting isn't required)

Steps

Install Java's OpenJDK8 Stuff - not to be confused with just only the OpenJRE

Install SDK & Create Keys - I think somewhere down the line you do get your freedoms violated because google and mobile phones in general but moving past that

Configuring

You can press on 'Configure' and go through this crap:

Questions you have to answer
    What is the Full name ..
        Snoot Game
    What is the Short name ..
        SnootGame
    What is the name of the package?
        cavemanon.snootgame
    What is the application's version?
        for the time being, 6.0.0
    Version code?
        6.0.0 -> 600, so 600
    How much ram?
        No larger than unused ram, in gigabytes/gibibytes
    Application to be displayed?
        In Landscape Orientation Only
    Which app store ..
        Neither
    Would you like to create an Expansion APK?
        No. Size Limit of ...
    Do you want to allow the app to access the Internet?
        No (Note: Ren'Py's default Updater isn't even supported on android, it's mostly a desktop only feature)
    Do you want to automatically update Java ..
        Yes. This is ...

OR copy this into .android.json

{"layout": null, "package": "cavemanon.snootgame", "include_pil": false, "numeric_version": "600", "expansion": false, "name": "Snoot Game", "update_always": true, "source": false, "icon_name": "SnootGame", "version": "6.0.0", "heap_size": "2", "update_icons": true, "permissions": ["VIBRATE"], "include_sqlite": false, "store": "none", "orientation": "sensorLandscape"}

Because for some dumb reason "google_play_key" & "google_play_salt" is in the same json build file, so the file isn't tracked. Oddly enough vibration is part of the permissions (the user won't be asked - some permissions have different levels, read the android developer docs for more info)

Toggle 'Release' instead of 'Debug' if you're going to distribute or don't care about debugging. Press 'Build Package' to build the apk file. Build & .. is only useful if you have usb debugging & adb installed & developer mode. You can manually install the snootgame apk on your phone, copy the file over to your phone, then find the file and tap it, it should prompt installation of the apk.

Optional Recording with scrcpy

scrcpy is used to record/playback your phone's display easily onto your computer, you can interact the phone with your mouse on the streamed display on your computer. It still requires adb

Other documentation

https://www.renpy.org/doc/html/android.html Phone Assets (all in the root folder)

android-icon_foreground.png
	The foreground layer of the icon. This should be 432x432 pixels and transparent.
android-icon_background.png
	The background layer of the icon. This should be 432x432 pixels and opaque.
android-presplash.jpg
	The image that's used when the app is loading. This should be surrounded by a monocolored border. That border is expanded to fill the screen.