https://github.com/electrostat-lab/jme3-simple-examples
Module based jMonkeyEngine android examples
https://github.com/electrostat-lab/jme3-simple-examples
activity-lifecycle android android-development android-library android-studio androidharness custom-android-view electrostat-lab fragments gradle java jmesurfaceview jmonkeyengine3 kotlin-android
Last synced: 6 months ago
JSON representation
Module based jMonkeyEngine android examples
- Host: GitHub
- URL: https://github.com/electrostat-lab/jme3-simple-examples
- Owner: Electrostat-Lab
- Created: 2021-04-09T05:11:12.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2022-05-07T11:48:00.000Z (over 3 years ago)
- Last Synced: 2024-09-19T19:48:14.756Z (over 1 year ago)
- Topics: activity-lifecycle, android, android-development, android-library, android-studio, androidharness, custom-android-view, electrostat-lab, fragments, gradle, java, jmesurfaceview, jmonkeyengine3, kotlin-android
- Language: Java
- Homepage: https://jmonkeyengine.org/
- Size: 386 KB
- Stars: 2
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# jme3-Simple-Examples
Module based jMonkeyEngine Android Simple Gradle Examples.
## In this repository, you will find 5 modules :
```gradle
include ':helloandroidui'
include ':hellofragmentharness'
include ':helloandroidharness'
include ':hellojmesurfaceview'
include ':hellokotlin'
include ':hellolemur'
include ':hellominie'
```
| helloandroidharness | hellofragmentharness | hellojmesrufaceview | helloandroidui | hellokotlin | hellolemur | hellominie |
|-------|------|-------|-------|-------|-------|-------|
| Tests jme game on an android activity `AndroidHarness` | Tests jme game on an android fragment `AndroidFragmentHarness` | Tests jme game on a custom android view `JmeSurfaceView` | Tests jme game on a surface view with some android ui usages showing best practice | Tests jme game using kotlin android plugin | Tests lemur integration and lemur stylying with a jMonkeyEngine game | Tests minie (bullet physics) with a jMonkeyEngine game |
## Quick start guide using android studio IDE :
1) Clone the repository.
2) Open android studio (any version would be fine) and `Get from version control` :
3) To test on physical device : connect your physical device and use the developer options to enable adb via usb debugging, you can refer to use
guide for more on devdloper options : https://developer.android.com/studio/debug/dev-options#debugging
4) To test on an emulator, android launches the selected emulator directly when you run an app module.
5) When opening android studio, you will find these modules, select a module and run :
6) Congrats ! Now you can play around with android and jMonkeyEngine apis !
## Quick start guide using command line gradle and adb :
1) Download the repository on your local disk.
2) Navigate to the root directory.
3) To start building an example use the following command :
> For windows
```bash
gradlew :helloandroidharness
```
> For linux/mac
```bash
./gradlew :helloandroidharness
```
4) To start dexing and build a debug apk for an example, use the following command :
> For windows
```bash
gradlew :hellofragmentharness:assemble
```
> For linux/mac
```bash
./gradlew :hellofragmentharness:assemble
```
5) To run directly on connected devices :
> For windows
```bash
gradlew :hellofragmentharness:installDebug
```
> For linux/mac
```bash
./gradlew :hellofragmentharness:installDebug
```
6) To dex a signed apk for google play, check this tutorial :
https://developer.android.com/studio/publish/app-signing
## For more about testing your application :
https://developer.android.com/studio/test
## The anatomy of jMonkeyEngine game android application :
| `SimpleApplication` | `Rendering Component` | `Android Activity` | `AppStates and Controls` |
|-------|------|-------|-------|
| Initializes and updates a jme game | Renders a `SimpleApplication` using a surface view (gl component) and passes it to android activity | The entry point and life cycle manager of android application, it holds the surface view |Game logic is distributed among these components and can be registered inside `SimpleApplication` class to be updated inside game loop |