π° This tool allows you to easy to build the app for RPG Maker MV using Cordova.
MIT License
This tool allows you to build your own Android APK File easily.
Export as your desired folder such as desktop after removing unused resource in RPG Maker MV.
Open the this builder and then select the folder called <YOUR GAME FOLDER>/www
there exists an index.html
file.
In this tool, there is pre-written contents, but you have to modify as your own settings.
Change an unused remove resources
as false after open up option window.
Click the build button and hold on until done.
if your cellphone is connected with personal computer using USB driver and others, you can install the apk file using google's adb tool automatically in your own devices.
adb install -r app-release.apk
This tool is based on C# Winform and Node.js and it has used a many of third-party tools. Some of them must be installed manually due to complexity of implementation. List that you must download is belows.
A higher version of the .Net Framework is required for a program developed with C# Winform to run.
βΆ Download : https://dotnet.microsoft.com/download/dotnet-framework
This tool must be needed the Android SDK(Android Software Development Kit) and JDK and more.
There are needed 28, 34 (latest) API specifically for building apk so you have to install using the Android Sdk Manager
beforehand.
βΆ Download : https://developer.android.com/studio/index.html?hl=ko
if you done installed them, you have to edit Environment Variables called path
on Windows.
%ANDROID_SDK_ROOT%
%ANDROID_SDK_ROOT%platform-tools\
μ무λλ μλλ‘μ΄λκ° κΎΈμ€ν μ λ°μ΄νΈ λκ³ μκΈ° λλ¬Έμ, μλλ‘μ΄λκ° λ²μ μ΄ μ¬λΌκ° λλ§λ€ νλ‘κ·Έλ¨λ€μ΄ λμνμ§ μλ λ¬Έμ κ° λ°μνκ³ μμ΅λλ€.
νλ‘κ·Έλ¨ μ¬μ©μκ° μμ§λ μμκ±°λΌκ³ μκ°λμ§ μκΈ΄ νλ°, μ μ§ λ³΄μλ₯Ό μν΄μ μΆνμ μλμ κ°μ λ΄μ©μ νμΈν΄μ ν¨μΉν μκ°μ λλ€.
κΈ°μ‘΄μλ cordovaλ₯Ό λΉλ‘―ν ν΅μ¬μ΄ λλ ν΄λ€μ΄ κΈ°μ‘΄μλ JDK8λ§μ μ§μνμμ΅λλ€.
βΆ μ€μΉ λ°©λ² : https://learn.microsoft.com/en-us/java/openjdk/download
νμ§λ§ νμ¬ cordova 12.0.0 κΈ°μ€μΌλ‘ JDK11 μ΄μμ΄ νμν©λλ€.
2024λ 2μ(νμ¬ κΈ°μ€ μ΅μ )μ μλλ‘μ΄λ μ€νλμ€λ₯Ό μ€μΉνμ λΆμ sdkmanagerκ° λ³λλ‘ μ€μΉλμ§ μκΈ° λλ¬Έμ μλμ κ°μ΄ λ³λλ‘ μ€μΉλ₯Ό νμ μΌ ν©λλ€.
βΆ μ€μΉ λ°©λ² : https://gradle.org/install/
C: μ μμΆμ νκ³ , C:\gradle-λ²μ λͺ \bin μ PATHμ μΆκ°ν΄μ€μΌ ν©λλ€ (gradle 7.6μμ μ μ λμ νμΈ)
μ΅κ·Ό μλμ° 11 μ€μΉ μ, 'λ¬Έμ'μ κ°μ ν΄λκ° νκΈλ‘ λμ΄μμ΄μ λ¬Έμ κ° μκΈ°κ³ μμ΅λλ€.
A problem occurred evaluating project ':app'.
> Failed to apply plugin 'com.android.internal.application'.
> Your project path contains non-ASCII characters. This will most likely cause the build to fail on Windows. Please move your project to a different directory. See http://b.android.com/95744 for details. This warning can be disabled by adding the line 'android.overridePathCheck=true' to gradle.properties file in the project directory.
νμ¬ νλ‘κ·Έλ¨μμλ λ¬Έμ
ν΄λμ μλμΌλ‘ ν΄λλ₯Ό λ§λ€κ³ μμ΄ λ¬Έμ κ° λκ³ μμ΅λλ€.
λ°λΌμ κ²½λ‘λ₯Ό C:\Users\<μ¬μ©μλͺ
>\AppData\Local\RPG Maker MV Cordova Builder
ν΄λλ‘ λ³κ²½νμμ΅λλ€.
μ½λ₯΄λλ°μ λ―Έμ¬μ© 리μμ€ μ κ±°κΈ°λ Node.jsλ‘ κ°λ°λ νλ‘κ·Έλ¨μ΄κ³ , λ Έλ ν¨ν€μ§ κ΄λ¦¬μλ₯Ό μ΄μ©νμ¬ μ€μΉ λ° μ λ°μ΄νΈλ₯Ό νκ² λ©λλ€. λ°λΌμ Node.jsκ° νμν©λλ€.
βΆ Download : https://nodejs.org/ko/download/
Node.js μ€μΉ μ΄νμ μννμ
μΌ ν©λλ€. μ¬μ€ λ³Έ νλ‘κ·Έλ¨ λ΄μλ μ½λ₯΄λλ° μ€μΉλ₯Ό μ§μ μννλ κΈ°λ₯μ΄ λ°λ‘ μμ§λ§, μμ§κΉμ§ νΉμ μν©μμλ§ μνλ©λλ€. λ°λΌμ μ§μ μ€μΉλ₯Ό ν΄μ£Όμ
μΌ ν©λλ€. κ³Όμ μ ctrl + rλ₯Ό λλ₯Έ ν, μ€νμμ cmd(λͺ
λ Ή ν둬ννΈ)λ₯Ό μ¬μ ν, npm install -g cordova
λ₯Ό μ
λ ₯νλ©΄ μ€μΉλ©λλ€.
βΆ μ€μΉ λ°©λ² : https://www.npmjs.com/package/cordova#installation
JDK 8μμλ§ μλλ‘μ΄λ API κ°μ Έμ€κΈ° λͺ λ Ήμ΄ μ μμ μΌλ‘ λμνκΈ° λλ¬Έμ JDK 8 μ€μΉκ° νμν©λλ€.
βΆ Download : https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
JDKκ° μ μμ μΌλ‘ μΈμλλ €λ©΄ μλμ°μ¦ νκ²½ λ³μλ₯Ό μ€μ ν΄μΌ ν©λλ€. νκ²½ λ³μλ Windows 10μ΄λΌλ©΄ μμ λ²νΌ μμ λ보기 λͺ¨μμ λ²νΌμ λλ¬ νκ²½ λ³μλΌκ³ μΉλ©΄ μ€μ μ΄ κ°λ₯ν©λλ€.
βΆ νκ²½ λ³μ JAVA_HOME μ€μ : https://zetawiki.com/wiki/%EC%9C%88%EB%8F%84%EC%9A%B0_JAVA_HOME_%ED%99%98%EA%B2%BD%EB%B3%80%EC%88%98_%EC%84%A4%EC%A0%95
λ³Έ νλ‘κ·Έλ¨μ΄ ꡬλ λλ €λ©΄ robocopy
λͺ
λ Ήμ΄ μ λλ‘ μ€νλλ μμ€ν
μ μ¬μ©ν΄μΌ ν©λλ€. robocopy
λͺ
λ Ήμ xcopy
μλ λ¬λ¦¬ μ΅μ 8 μ°λ λλ‘ λμμ νμΌμ κ³ μ 볡μ¬ν μ μλ Windows
νμΌ λ³΅μ¬ νλ‘κ·Έλ¨μ
λλ€. λ³Έ νλ‘κ·Έλ¨μ νμΌμ λͺ©μ ν΄λμ κ³ μμΌλ‘ νμΌμ λ³΅μ¬ νκ² λ©λλ€. μ΄ κΈ°λ₯μ λ―Έμ¬μ© 리μμ€ μ κ±° κΈ°λ₯μ μ¬μ©νμ§ μμ λμλ§ λμν©λλ€. λ―Έμ¬μ© 리μμ€ μ κ±° κΈ°λ₯μ μ¬μ©ν λ νμΌμ μ λ³μ μΌλ‘ λ³΅μ¬ ν©λλ€.
μ± λΉλ μ μΆκ° κΈ°λ₯μ μνμλ λΆλ€μ΄ μμΌμλ©΄ λ€μ νμΌλ€μ λ΄λ € λ°μ ν, μμΆμ ν΄μ νκ³ js/plugins
ν΄λμ λ£μ΄μ£ΌμκΈ° λ°λλλ€.
μ’ λ£ λν μμλ κΈ°λ³Έμ μΌλ‘ ν¬ν¨λμ΄μμ§ μμ΅λλ€. κ°μ λ‘ ν¬ν¨ν μ λΉλ μκ°μ΄ μ’ μΆκ°λκΈ° λλ¬Έμ λλ€.
λ°±μ€νμ΄μ€ λ²νΌ ν°μΉ μ μ’ λ£ λν μμ λμ°κΈ° - λ€μ΄λ‘λ[ZIP]
μ λλͺΉμ κ²½μ°, νλ¬κ·ΈμΈ μΆκ° κ³Όμ μμ νΉμ μΈμλ₯Ό λκ²¨μΌ ν©λλ€. ν΄λΉ μΈν μ νλ‘κ·Έλ¨μμ μλμΌλ‘ μ§μνλλ°μ.
μ λλͺΉ κ΄κ³ λͺ¨λ (λ°°λ, λμμ κ΄κ³ , 보μν κ΄κ³ ) - λ€μ΄λ‘λ[ZIP]
μλμΌλ‘ μΈν μ νλ €λ©΄ λ€μ νλ¬κ·ΈμΈμ μΆκ°λ‘ λ£μ΄μΌ ν©λλ€.
βAdmobSettings.js - λ€μ΄λ‘λ[ZIP]
βνλ¬κ·ΈμΈμ μ£Όμ λΆλΆ(/*: ~ */ μ¬μ΄ λΆλΆ)μ @cordova_plugin cordova-plugin-admob-free
λ‘ μμνλ λΌμΈμ΄ μμ΅λλ€.
/*:
* @cordova_plugin cordova-plugin-admob-free --save --variable ADMOB_APP_ID="ca-app-pub~μλ΅
*/
ν
μ€νΈ μλν°λ₯Ό μ΄μ©νμ¬ ADMOB_APP_ID
λΆλΆμ ν
μ€νΈ κΈ°κΈ° μ© APP ID
λ₯Ό μ λλͺΉ μ¬μ΄νΈμ μλ μ± IDλ‘ μμ μ ν΄μ£ΌμκΈ° λ°λλλ€.
νλ©΄ κΊΌμ§ λ°©μ§ νλ¬κ·ΈμΈμ νμ κΈ°λ₯μ΄λ―λ‘ κ°μ λ‘ μΆκ° λ©λλ€.
κ²μ ν΄λλ₯Ό μ€μ ν λ νλ¬κ·ΈμΈμ΄ μλ μΈμλλ μ리λ νλ¬κ·ΈμΈ κ΄λ¦¬μμ μ리μ λμΌνκ² μ½λ©νΈλ₯Ό νμ±νλ λ°©μμ λλ€.
λ°λΌμ λ€μκ³Ό κ°μ μμμ μ£Όμμ μ½μ ν΄μΌ ν©λλ€.
μ΄λ κ² νλ©΄ νλ‘μ νΈλ₯Ό λΆλ¬μ¬ λ cordova-plugin-dialogs
λΌλ νλ¬κ·ΈμΈμ΄ μλμΌλ‘ λΉλ κ³Όμ μ μΆκ°λ©λλ€.
μ΅μ νλ₯Ό μν΄ λΌμΈμ μ΅μνμΌλ‘ μ½μΌλ μ΅μλ¨ λΆλΆμ λ£μ΄μ£ΌμΈμ.
/*:
* @cordova_plugin cordova-plugin-dialogs
*/
λΉλ μ€μ μ€λ₯κ° λ°μνμ λ, Log
μ°½μμ μ€λ₯Έμͺ½ λ²νΌμ λλ₯΄λ©΄ λΉλ λ‘κ·Έ μ μ₯ λ²νΌμ μ¬μ©νλ©΄ λ‘κ·Έ μ μ₯μ΄ κ°λ₯ν©λλ€.
μλ μ¬μ΄νΈμ λ²κ·Έλ₯Ό μ 보ν λ λΉλ λ‘κ·Έλ κ°μ΄ μ¬λ €μ£ΌμκΈ° λ°λλλ€.
μ μμ μΈ λΉλ λ‘κ·Έ :
--- μ€λΉ ---
java version "1.8.0_121"
Java(TM) SE Runtime Environment (build 1.8.0_121-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.121-b13, mixed mode)
-- keytoolμ μ°Ύμμ΅λλ€.
9.0.0 ([email protected])
μλλ‘μ΄λ SDK / ANDROID_SDK_ROOTλ₯Ό μ°Ύμμ΅λλ€ : E:\Android\sdk\
[SDK]==========================================
android-19
android-23
android-26
android-27
android-28
android-29
==============================================
--- νμν λͺ¨λ νλ‘κ·Έλ¨μ΄ μ€μΉλμ΄μμ΅λλ€.
νλ‘κ·Έλ¨μ΄ μ΅μ λ²μ μΈμ§ νμΈ μ€μ
λλ€... (1μ΄ λ―Έλ§)
μ΅μ λ²μ μ μ¬μ©νκ³ μμ΅λλ€.
μ½λ₯΄λλ°κ° μ΅μ λ²μ μΈμ§ νμΈ μ€μ
λλ€... (5μ΄ λ―Έλ§)
νμ¬ μ΅μ λ²μ μ μ½λ₯΄λλ°λ₯Ό μ¬μ©νκ³ μμ΅λλ€.(00:00:04.7386189)
νκΈλ‘ λ νμΌλͺ μ μμ§ κ΅¬κΈ μλλ‘μ΄λ μ± λΉλμμ μ§μνμ§ μμΌλ νμΌλͺ μ λ°λμ μμ΄μ¬μΌ ν©λλ€.
μλμ° μ¬μ©μ κ³μ λͺ κ³Ό κ·Έ λΆμ ν΄λλ€λ μμ΄λ‘ λμ΄μμ΄μΌ ν©λλ€.
https://github.com/biud436/MV-App-Builder/issues
λ€μ λ§ν¬μμ μ΅μ λ²μ μ λ΄λ € λ°μΌμκΈ° λ°λλλ€ (μλ μ λ°μ΄νΈ κΈ°λ₯ μμ)