novafarma/ANDROID_GUIDE.md

📱 Building NovaFarma for Android

This guide explains how to pack your NovaFarma game into an Android APK using Capacitor.

Prerequisites

1. Node.js (Already installed)
2. Android Studio (Download and install from developer.android.com)
   • Ensure you install the Android SDK and create a Virtual Device (AVD) or enable USB debugging on your Android phone.

Steps

1. Install Capacitor

In your project terminal (Game Folder), run:

npm install @capacitor/core @capacitor/cli @capacitor/android

2. Initialize Capacitor

Initialize the project config. Since your project serves files directly from the root:

npx cap init NovaFarma com.novafarma.game --web-dir .

3. Add Android Platform

This creates the native Android project folder.

npx cap add android

4. Sync Project

This copies your web assets (html, css, js) into the Android native project.

npx cap sync

5. Open in Android Studio

npx cap open android

This will launch Android Studio with your project loaded.

6. Run on Device

• Connect your Android phone via USB (Developer Mode enabled) OR start an Emulator in Android Studio.
• Click the green Run (Play) button in the top toolbar.
• The game should launch on your device!

7. Export APK (For Sharing)

To create a standalone file you can send to friends:

• Go to Build > Build Bundle(s) / APK(s) > Build APK(s).
• Once finished, a notification will appear. Click "Locate" to find your app-debug.apk.

🎮 Mobile Controls

We have already enabled Virtual Joystick support in the UIScene.

• A joystick appears on the bottom-left of the screen.
• Use it to control the character without a keyboard!

Happy Slaying! 🧟📱