Picture Puzzle Cube Game – Android Source Code

Overview

🧩 Picture Puzzle Cube is an engaging Android puzzle game where players rotate cubes to complete pictures.

📱 Built entirely in Android Studio—easy to customize and reskin.

Features

🔧 100% native Android Studio project (Java/Kotlin)

🧠 Fully functional puzzle cube mechanics

📜 Clean and well-commented code for easy customization

🎨 Replace images and branding in minutes

⚡ Optimized for smooth performance on most devices

💰 AdMob integration ready (if included)

📱 Adaptive UI: The user interface adjusts dynamically to different screen sizes and orientations, providing an optimized experience on both small phone screens and larger tablet/TV displays.

🎮 Gamepad/D-pad Support: For devices without touchscreens (e.g., Fire TV, Android Automotive), the application now fully supports navigation and interaction using D-pad and gamepad inputs.

⬆⬇⬅➡ D-pad: Corresponds to U/D/L/R cube moves.

🅰 / ❌ Button: Shuffle the cube.

🅱 / 🔼 Button: Reset the cube.

L1/R1 Button: Undo last move.

⏯ Start/Select Button: Open instructions.

L2 Button: Toggle Prime moves.

R2 Button: Show hint.

🕹 Thumb L/R Buttons: Set difficulty to Medium (example, can be extended for cycling difficulties).

📝 Manifest Declarations: The AndroidManifest.xml includes necessary declarations to ensure the app is discoverable and functions correctly on Android TV (Leanback launcher) and Android Automotive OS.

Requirements

💻 Android Studio (latest stable version recommended)

📘 Basic understanding of Java/Kotlin development

📱 Android device or emulator for testing

🌐 Internet connection (only if using ads)

Instructions

1. Requirements

• Android Studio (latest stable version recommended)
• Basic knowledge of Java/Kotlin development
• Android device or emulator for testing

2. How to Open the Project

1. Download and extract the ZIP file.
2. Open Android Studio.
3. Click File → Open and select the project folder.
4. Let Gradle finish syncing automatically.

3. How to Customize

• Change game images:
• Replace puzzle images inside the /res/drawable folder.
• Keep the same file names or update references in the code.
• Change app name and icon:
• Update app_name in res/values/strings.xml.
• Replace the launcher icon in /mipmap folders.
• Change package name (optional):
• In Android Studio, right-click your package → Refactor → Rename.
• Update the applicationId in app/build.gradle.

4. Add AdMob (if using ads)

1. Open AndroidManifest.xml and insert your AdMob App ID.
2. Open the code file where ads are loaded and replace the test ad unit IDs with your own.
3. Test ads before publishing to Google Play to ensure proper integration.

5. Build & Run

• Connect your Android device or start an emulator.
• Click Run ▶ in Android Studio.
• Your app should launch automatically.

6. Support

• This is a self-contained project designed for developers.
• Ensure you meet all requirements above before starting customization.