什么是MV Android客户端

MV Android客户端是Android™操作系统的运行时客户端，用于使用RPG Maker MV游戏开发工具包创建的游戏。

此客户端可用于将您的游戏作为Android APK包进行分发。

Android Studio的当前要求：

• 最小3 GB RAM，建议8 GB RAM; 加上1 GB的Android模拟器

• 2 GB可用磁盘空间最小值，4 GB建议 (500 MB for IDE + 1.5 GB for Android SDK and emulator system image)

• 最小屏幕分辨率为1280 x 800

如何获得MV Android客户端

客户端的最新可以通过这个URL下载：github.com/AltimitSystems/mv-android-client/zipball/master

教程和使用支持

• 预备知识

• 创建Android应用程序
  

• 测试（可选）

• 创建调试APK

• 定制

• Crosswalk vs WebView

什么是MV Android客户端

MV Android客户端是Android™操作系统的运行时客户端，用于使用RPG Maker MV游戏开发工具包创建的游戏。

• 下载来源

• 在GitHub上查看

本教程使用MV Android客户端为Android编译RPG Maker MV项目（作为Android APK部署）。

预备知识

MV Android客户

从URL获取MV Android客户端源代码：

github.com/AltimitSystems/mv-android-client/zipball/master
Or by cloning the GitHub repository with git:
github.com/AltimitSystems/mv-android-client.git

This is a zip folder of the latest version of the MV Android Client.

这是MV Android客户端的最新版本的zip文件夹。

将此zip文件夹解压到一个难忘记的位置（例如您的计算机桌面文件夹）。

开发环境

Android应用程序开发的官方IDE是Google的Android Studio。

可以为macOS下载Android Studio，Microsoft Windows和Linux，网址如下：
developer.android.com/studio

可以在以下URL找到适用于您平台的Android Studio安装说明：developer.android.com/studio/install.html

Android SDK库

当打开Android Studio是第一次，您将看到一个欢迎窗口，描述您已安装的Android Studio版本以及用于创建项目的一些快速选项。

如果这不是您第一次打开Android Studio并且出现以前的项目，则可以通过从“文件”菜单中关闭当前项目并选择“关闭项目”来访问欢迎窗口。

欢迎窗口的右下角是配置菜单。打开此菜单并选择SDK Manager以启动Android SDK Manager。这是您可以下载项目所需Android SDK库的地方。

您也可以通过工具菜单在打开的项目中打开Android SDK管理器，选择Android子菜单，然后选择SDK管理器。

所需的SDK平台

Android SDK管理器有三个选项卡; SDK平台，SDK工具和SDK更新站点。

要下载所需的SDK平台，请确保已选择SDK平台选项卡。这是您可以下载多种Android版本的开发库的地方。

通常最好选择最新版本的Android进行安装。在撰写本教程时，最新版本的Android是“Android 8.0（Oreo）”。

选中您希望安装该SDK的Android版本左侧的框，然后单击应用以开始下载所需的SDK平台。

所需的SDK工具

下载SDK平台后，选择SDK Tools标签开始下载开发Android应用程序所需的工具。

从此列表中，选中以下SDK工具左侧的框：

 

• Android SDK构建工具

• Android SDK平台 - 工具

• Android SDK工具

• 支持存储库

如果你想在手机设备上测试你的应用，你可能还需要检查谷歌USB驱动程序，如果你在Windows上。

单击应用开始下载所需的SDK工具。

部署的RPG Maker MV项目

要为Android准备RPG Maker MV项目，您必须从File菜单中选择Deployment ...选项。

在出现的部署窗口中，确保选择了Android / iOS平台。

请记住为部署选择一个输出位置，您可以通过单击选择...按钮来完成此操作。您需要稍后才能找到此输出位置，因此请确保它位于一个易于查找，难忘的地方（例如您的计算机桌面文件夹）。

单击确定开始部署。

创建Android应用程序

打开MV Android客户端

从Android Studio欢迎屏幕中，选择打开现有的Android Studio项目。

在“Prerequisites”的开头处找到解压下载的MV Android客户端源代码的文件夹。

选择该文件夹，使其突出显示，然后单击确定。Android Studio在打开项目后可能需要一些时间来构建项目。

等待项目在Android Studio中解决。该项目将自动下载所需的其他库，因此需要连接互联网来加载项目。

Once everything is settled, expand the Project tab at the upper far left and expand the Build Variants tab at the lower far left.

Expanding the app folder in the Project tab should have the manifests, java code and xml values.

The Build Variants section can be used to switch between Crosswalk and WebView as the default web-engine.

Crosswalk development ended in January 2017, so it is better to use WebView, however older devices may not be fully compatible with WebView features. See the end of this tutorial for a more in-depth explanation on Crosswalk vs WebView.

导入已部署的RPG Maker MV项目

创建Assets文件夹

如果Assets文件夹在Android Studio的应用程序文件夹中不存在，就必须创建它。Assets文件夹用于存储已部署的RPG Maker MV项目。

Right-click on the app folder to open the context menu. Open the New submenu, then open the Folder submenu lower down. From here, click the Assets Folder to begin creating the Assets folder.

然后在出现的窗口中单击确定。

复制RPG Maker MV项目文件

查找在prerequisites期间创建的已部署的RPG Maker MV项目。里面应该是一个www文件夹。

选择www文件夹，使其突出显示，并通过右键单击该文件夹并选择复制选项来复制该文件夹。

回到Android Studio，您现在想要右键单击Assets文件夹并通过选择粘贴选项来粘贴www文件夹。

在出现的复制窗口中，确保在编辑器中打开复制未被选中，以防止在Android Studio中打开MV项目文件，然后单击确定。

根据您的MV项目的大小，将其复制到Android Studio可能需要一段时间。

修改applicationId

The Android applicationId must be unique to your project.
Android applicationId对于项目必须为唯一
Expand the Gradle Scripts and open the build.gradle (Module: app) file.

看到类似于上面的图像。在defaultConfig中找到具有applicationId的行。

Change the text inside the quotes to a new applicationId. Android applicationIds must contain no spaces and must be lower-case Latin characters with periods between each word.

Generally, they are domain names in reverse with the app name at the end. An example for a project call "Adventure" made at HBGames.org would be "org.hbgames.adventure".

If you do not have a website domain, you can use your first and last name. A project called "Owl Chronicles" by someone called "Harry Potter" would be "potter.harry.owlchronicles".

It must be unique to your project and your studio.

测试 (optional)

如果您有Android手机，可以将其连接到电脑以直接测试您的MV项目。

A guide for setting up a phone for testing is available at this URL:
developer.android.com/studio/run/device.html

Alternatively, you may create an Android emulator instance. An emulator runs on your computer and does not require an Android phone.

A guide for setting up an emulator instance for testing is available at this URL:
developer.android.com/studio/run/emulator.html

创建调试APK

从Android Studio中，选择Build，然后单击Build APK。

这将编译和构建您的应用程序，这可能需要一些时间。完成后，在Android Studio的右下角，您将看到一条确认消息，其中包含一个到您APK的短链接。

点击链接将为您打开文件夹，您可以在其中复制和分享APK。

这是一个调试APK，因此它尚未准备好发布到Google Play商店。本教程不会涵盖发布发布APK，并且不会针对与发布的APK相关的问题提供支持。有关创建发行版APK的信息，请参阅URL：
developer.android.com/studio/publish

自定义

大多数自定义操作都可以在values.xml文件中完成。

应用程序名称

要重命名您的应用程序，请打开values.xml文件并查找app_name条目。默认情况下，该应用程序被称为RPG Maker MV。

Unicode必须用于非拉丁字符（如中文字符）。使用一个unicode转换器为XML生成这些。

应用网站

网站URL在values.xml文件中配置. Change the app_host to your website domain and app_scheme to HTTP or HTTPS. As an example, if my website is https://www.hbgames.org then my app_scheme will be "http" and my app_host will be "hbgames.org".

After that, my website will need to be associated with the app. See the section "Associate your app with your website" at the URL:
developer.android.com/studio/write/app-link-indexing.html

App Icon

Open up the res/mipmap folders to view the app icons.

您可以删除所有这些图标以删除默认图标，但是您必须用两个图标替换图标，一个名为“app_icon”，另一个名为“app_icon_round”。

这些可以是PNG图像，或者您可以通过右键单击mipmap文件夹，打开New子菜单并选择Image Asset，使用Android Studio创建它们。

Image Asset Studio的指南位于URL：
developer.android.com/studio/write/image-asset-studio.html

请记住有两个图标名为“app_icon”和“app_icon_round”！正常情况下，app_icon_round将是一个圆形图标。

Crosswalk vs WebView

Crosswalk是英特尔的一个项目，旨在为Android创建一个可移植的WebView替代品，可用于多个Android版本。crosswalk-project.org

You may know of Crosswalk from Intel XDK, Cordova and PhoneGap. It is also featured as part of the "official" Android deployment guide for RPG Maker MV.

Modern Android has separated the WebView component from the operating system, so now old versions of Android can receive critical security updates for WebView without needing a complete operating system update. This has made Crosswalk redundant as Crosswalk's main goal was to provide WebView updates for old versions of Android.

So why use Crosswalk? Unfortunately, WebView updates haven't enabled some features for older devices. Namely, WebAudio and WebGL might not be available for old Android phones. Crosswalk may have these implemented for old devices, so with Crosswalk there is a possibility that compatibility can be improved.

This is not a win-win situation, however. WebView can work on even older version of Android than Crosswalk (Going as far back as Android 3.0 Honeycomb API 11). WebView may even be faster than Crosswalk for newer devices.

The critical difference is that Crosswalk is no-longer in development, so it will not receive security updates. If a bug appears in Crosswalk that allows people to hack devices and break phones through your app or game then you're out of luck. With WebView, an update from Google will fix the issue rapidly.

WebView is also a core part of Android itself. Using Crosswalk can increase the size of the APK as all the Crosswalk libraries and files for all the potential versions of Android and phone devices need to be included as well.

The recommendation from security-conscious developers such as myself is that WebView should be used and Crosswalk avoided. Crosswalk should be used at your own risk.

If a serious security issue for Crosswalk does appear in the future, it will be removed from future versions of the MV Android Client.

A tutorial is hosted at HBGames.org at the following URL: hbgames.org/forums/viewtopic.php?f=48&t=79391

本教程提供了使用支持。