This Sliding Puzzle Game is a modern take on the classic puzzle game where the objective is to arrange scrambled pieces into a specific order by sliding them around the board. Developed with Android's latest Jetpack Compose UI toolkit, this game demonstrates the use of modern Android development practices, including MVVM architecture, StateFlow for state management, and reactive UI updates.
This is my first Android - Kotlin - Jetpack Compose project.
- Modern Android Architecture: Utilizes MVVM (Model-View-ViewModel) for clear separation of concerns and easier maintenance.
- Reactive UI Updates: Leverages Jetpack Compose and StateFlow for responsive and interactive user experiences.
- Engaging Puzzle Mechanics: Players can enjoy the timeless challenge of solving sliding puzzles with intuitive touch controls.
- Android Studio (version details in the project settings)
- JDK (version details in the project settings)
- An Android device or emulator
-
Clone this repository to your local machine:
git clone https://codeberg.org/rico-de/Slizzle.git -
Open the project in Android Studio:
- Start Android Studio.
- Choose "Open an Existing Project" and navigate to the cloned repository folder.
- Android Studio will automatically import the project and install the necessary dependencies.
-
Add a
app/src/main/res/values/api_keys.xmlfile holding your Pixabay API key:
<resources>
<string name="pixabay_api_key">YOUR_API_KEY_HERE</string>
</resources>-
Run the application:
- Connect your Android device or start an emulator.
- Press the "Run" button in Android Studio to build and run the application.
- Choose a picture.
- Select the desired puzzle size.
- Start the game
- Interact withe the puzzle pieces by tapping on them or just swiping them around.
- Import pictures from Pixabay or directly from the device camera.
- To delete pictures: Long press on a Picture to delete it individually or clear all app data to remove all imported pictures.
Distributed under the UNLICENSE License. See LICENSE for more information.