RMMV-android-deployment

KO | EN

gitlite — search

#javascript #python #react #go #golang #android #rust #docker #windows #cli #kubernetes #vue #security #open-source

RMMV-android-deployment

(★ 9)

The project is a library which help RMMV game creaters to build Android version of their games very easy. The project is built by kotlin, so the codes of it are less and easy to read then Java

RMMV-android-deployment Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# RMMV-android-deployment

## [点击阅读中文文档](https://github.com/huhao1987/RMMV-android-deployment/blob/master/README.zh_CN.md "简体中文")

*The project is built on https://github.com/AltimitSystems/mv-android-client, although it has changed a lot of code. Thanks for Altimit Systems` code!*

#### The project is a library which helps RMMV game creators to build  _Android_  version of their games very easy.
**The project is built by kotlin, so the codes of it are less and easier to read than Java**

## Update Log ##
**Add Save type support**

**Add Android internal storage save support(with my RMMV plugin)**

**Add custom save path setup**

## How to use the library
#### Basic steps
1. You need the latest Android studio, currently, the latest version is 3.6.3.
2. Create a new Android project with "empty activity" or open your exist Android project.
3. After "Gradle Build Running" finish, choose the "build.gradle(Project:xxxx)", add "maven { url 'https://jitpack.io' }" in allproects
```kotlin
allprojects {
    repositories {
        google()
        jcenter()
         maven { url 'https://jitpack.io' }

}
}
```

4. in "build.gradle(Module:app)", add below line in dependencies
```kotlin
implementation 'com.github.huhao1987:RMMV-android-deployment:1.0.9'
```

5. choose "manifests", in "activity" tag, add
```kotlin
       android:configChanges="orientation|screenSize"
       android:screenOrientation="sensorLandscape"
```
to make the game run as horizontal screen

* If your game need network connection

5.1 please add 
```kotlin
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```
5.2 in "application" tag, add 
```kotlin
        android:networkSecurityConfig="@xml/network_security_config"
```
5.3 right click "app"->"New"->"Android Resource Directory",  then choose "xml" in Resource type.
    right click "xml"->"New"->"XML Resource file",name it as "network_security_config", and copy the code below inside
```kotlin
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true" />
</network-security-config>
```
5.1 and 5.2 are used to give the network permission for your game, or it cannot connect to the Internet. 5.2 ensure that the app can connect to both "http" and "https"

6. Now add the rpgPlayerView view in the layout of your mian activity(If you just create a new project, it should be named "MainActivity", and the name of layout should be "activity_mian")
```kotlin
 <hh.rpgmakerplayer.webviewmodule.rpgPlayerView
        android:id="@+id/rpgwebview"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
 ```
 
7. If your project doesn`t have assets folder, right click "app"-"New"->"Folder"->"Assets Folder",Put the folder "www" of RMMV game in to "assets" folder.

8. In MainActivity add the lines in onCreate
* kotlin:
```kotlin
rpgwebview.build()
rpgwebview.Playgame("//android_asset/www/index.html")
```
* Java:
```Java
rpgPlayerView rpgwebview=findViewById(R.id.rpgwebview)
rpgwebview.build()
rpgwebview.Playgame("//android_asset/www/index.html")
```

9. Build and run the debug game on your phone.

## Advance 
You can use some features in the build function of rpgPlayerview.
1) open as fullscreen or not
```kotlin
rpgwebview
 .isfullscreen(false/true)
 .build()
 ```
2) use your own evaluateJavascript as String
 ```kotlin
rpgwebview
 .setevaluateJavascript(xxxxxx)
 .build()
 ```
 
3) **Android save support**

As the limitation of Android system, the RMMV cannot store the save in the internal storage. I wrote a RMMV plugin to support it.
   It`s easy to use, just use my deployment method above to create your Android game project, and Add the "hh_Android_save.js" from [here](https://github.com/huhao1987/RMMV-Plugins), and add it in your RMMV game project and turn on it.
   
 4) **custom save path setup**
 
    Add custom save path setup function which allows you to storage the save locally, but you need to add the write storage permission firstly.
     
 ```kotlin
rpgwebview.setupcustompath("your path")
rpgwebview.build()
   ```
   **Remember to update the assets folder in your android project after modification**
   
   After these stages, when you test and play the game, the game saves will be saved in the internal storage, right now the path will be in the root folder, you could only find out them if you rooted your phone.
    
5) More features comming....

RMMV-android-deployment

RMMV-android-deployment Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

RMMV-android-deployment

RMMV-android-deployment Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README