Android export

# Linux
sudo apt install openjdk-17-jdk

# macOS (using Homebrew)
brew install openjdk@17

# Windows
# Download from https://adoptium.net/

# Essential Android export settings
# These are configured in the export preset

# Package name (reverse domain notation)
# Example: com.yourcompany.yourgame
Package Name: "com.example.mygame"

# Version code (increment for each release)
Version Code: 1

# Version name (displayed to users)
Version Name: "1.0.0"

# Minimum SDK version
Min SDK: 21  # Android 5.0 Lollipop

# Target SDK version
Target SDK: 33  # Android 13

# Export APK
godot --headless --export-release "Android" "builds/game.apk"

# Export AAB
godot --headless --export-release "Android" "builds/game.aab"

# Default debug keystore location
# Linux/macOS: ~/.android/debug.keystore
# Windows: %USERPROFILE%\.android\debug.keystore

# Generate release keystore
keytool -genkey -v -keystore release.keystore -alias mygame \
  -keyalg RSA -keysize 2048 -validity 10000

# Enter password and information when prompted

# Release signing configuration
Keystore:
  Release: "path/to/release.keystore"
  Release User: "mygame"
  Release Password: "your_keystore_password"

# Configure in export preset under "Permissions"

# Network access
ACCESS_NETWORK_STATE: true
INTERNET: true

# Storage
READ_EXTERNAL_STORAGE: true
WRITE_EXTERNAL_STORAGE: true

# Location
ACCESS_FINE_LOCATION: false
ACCESS_COARSE_LOCATION: false

# Vibration
VIBRATE: true

# Camera/Microphone
CAMERA: false
RECORD_AUDIO: false

func request_permission(permission: String):
    if OS.get_name() == "Android":
        var permission_name = "android.permission." + permission
        if not OS.has_permission(permission_name):
            OS.request_permission(permission_name)

func check_permission(permission: String) -> bool:
    if OS.get_name() == "Android":
        var permission_name = "android.permission." + permission
        return OS.has_permission(permission_name)
    return true

# Usage
func _ready():
    if not check_permission("CAMERA"):
        request_permission("CAMERA")

// MyPlugin.kt
package com.example.mygame

import org.godotengine.godot.Godot
import org.godotengine.godot.plugin.GodotPlugin

class MyPlugin(godot: Godot) : GodotPlugin(godot) {
    
    override fun getPluginName() = "MyPlugin"
    
    @UsedByGodot
    fun showToast(message: String) {
        runOnUiThread {
            Toast.makeText(activity, message, Toast.LENGTH_SHORT).show()
        }
    }
}

var my_plugin

func _ready():
    if Engine.has_singleton("MyPlugin"):
        my_plugin = Engine.get_singleton("MyPlugin")
        my_plugin.showToast("Hello from Android!")

# In export preset
Screen Orientation: 1  # 0=Landscape, 1=Portrait, 2=Sensor

# Or change at runtime
DisplayServer.window_set_orientation(DisplayServer.SCREEN_LANDSCAPE)

# Set in export preset
Launcher Icons:
  Main 192x192: "res://icon_192.png"
  Adaptive Foreground 432x432: "res://adaptive_foreground.png"
  Adaptive Background 432x432: "res://adaptive_background.png"

# Configure splash screen
Splash Screen:
  Show Image: true
  Image: "res://splash.png"
  Bg Color: Color(0, 0, 0, 1)

# Enable in export preset
Google Play Services:
  Enable: true
  
# Example: Google Play Games Services
func sign_in_google_play():
    if Engine.has_singleton("GooglePlayGameServices"):
        var gpgs = Engine.get_singleton("GooglePlayGameServices")
        gpgs.sign_in()

# Increment for each update
Version Code: 2  # Must be higher than previous
Version Name: "1.0.1"  # Displayed to users

# Enable wireless debugging
adb tcpip 5555
adb connect DEVICE_IP:5555

# Deploy to device
adb install -r game.apk

# Check if running on Android
if OS.get_name() == "Android":
    # Android-specific code
    print("Android version: ", OS.get_version())
    print("Device model: ", OS.get_model_name())

func _ready():
    if OS.get_name() == "Android":
        # Prevent screen from sleeping
        OS.screen_keep_on = true
        
        # Get safe area (for notches)
        var safe_area = DisplayServer.get_display_safe_area()
        
        # Handle back button
        get_tree().set_quit_on_go_back(false)

func _notification(what):
    if what == NOTIFICATION_WM_GO_BACK_REQUEST:
        # Handle Android back button
        show_quit_dialog()