永久保存版! 『RPGツクールMV』のAndroidアプリ化でよくあるエラーと対処法


私事だが、RPGツクールMV製の拙作「人格診断MV」を、ついこの前アプリ化してGoogle Playストアに公開することができた。

Androidアプリ化までは決して易しいものではなく、数多の手順を踏む必要があっただけではなく、いくつかのエラーと格闘することになった。

一筋縄ではいかなかったんだね……。

とはいえ、アプリ制作未経験者が非プログラミングで3日で作ったゲームを公開できたのは事実。やはりツクールMVのポテンシャルはやばい。慣れたらクソアプリを量産できる。

クソを量産するのはまずいんじゃないですかね……。

アプリ化のための初期設定・環境構築

ツクールMVで一度もアプリ化したことがないって人は、[必読]RPGツクールMV で、Androidアプリ用のapkファイルにパッケージングするための初期設定まとめの記事を読んでくれ。僕が懇切丁寧にまとめた、超分かりやすくて超ありがたい解説が載っている。

親切の押し売りはやめようね。

初期設定を済ませた後にアプリ化をする方法は、初期設定を済ませた後に、RPGツクールMVでAndroid用apkファイルを出力する方法の記事をどうぞ。まあ、すでにそこまで済ませた上でエラーに悩んでいる人が、今この記事を読んでいるんだろうけどな。念のため。

コマンドプロンプトからmake_apk.pyを実行した時のエラー対処

ファイル名・フォルダパスに全角文字はないか?

BUILD FAILED
C:\android-sdk\tools\ant\build.xml:928: The following error occurred while executing this line:
C:\android-sdk\tools\ant\build.xml:946: null returned: 1

具体的な行番号は異なるかもしれないが、このようなエラー文が出た場合、ファイル名やフォルダ名に全角文字が無いか確認してみよう。

例えば、BGM素材で「ラスボス戦.m4a」なんて名前にしているとアウト。半角英数で「lastbattle.m4a」などに変えよう。当然、素材のファイル名を変えた場合は、ツクールのエディタで曲を再指定する必要がある。

また、キャラクターチップなどはファイル名の先頭に ! や $ マークをつけることで挙動が変わるのだが、こちらもトラブルの元なので、もしエラーが直らないようであれば合わせて修正しておきたい。

また、直接ゲームデータとは関係ないファイル……例えば、ゲームフォルダ直下にちょっとしたメモとして「新しいテキスト.txt」などを置いた場合もエラーになる。ファイル名を変えるか移動させよう。フォルダパスも日本語が含まれていると駄目なので、Cドライブ直下に移動させるなどの対策を。

管理者権限で、ゲームフォルダ直下で実行しているか?

cmd

初歩的なことではあるが、Android / iOS用にデプロイした後の「www」フォルダ直下でコマンドプロンプトを実行する必要がある。念のため、管理者権限で実行するようにしよう(しなくても上手くいく場合もある)。

manifest.json ファイルはあるか? ファイル名のつづりを間違えていないか?

Error: The manifest file does not exist.

このエラーが出た場合、manifest.jsonファイルが取得できていない。ファイル名は間違えていないか、wwwフォルダ直下に置いてあるか、そもそもちゃんと用意してあるかを確認しよう。ゲームフォルダ直下で実行していない場合も同様のエラーが出る。

その他のトラブル対処

Playストアでバージョンアップが上手くいかない

バージョン コード 1 の APK が既に存在するため、別のバージョン コードを使用する必要があります。

Google Playストアにてアップデートすべく、新しいapkファイルをアップロードした時にこんなエラーを吐く場合がある。この場合、manifest.jsonファイルのバージョンを変えても駄目。Crosswalk Project のmake_apk.py の versionCode を1から2に書き換えよう。なお、今後もアップデートする場合は、同様に数字を上げていく必要があるし、別のゲームをアプリ化する場合はまた1に戻してやる必要がある。忘れないようにゲームごとの数字をメモしておくといいかもしれない。

Crosswalk Projectの場所は、記事通りに初期設定を済ませたのであればCドライブ直下にある。

なお、この問題解決にあたり、ツクマテのトピックが参考になった。この場を借りてお礼を申し上げます。

参考リンク:スマホアプリのバージョンアップができない。 – ツクマテ

以上。他にも「こんなエラーでつまずいたよー」ってのがあれば、コメントに書いてみてください。解決策を示せるかもしれないし、無理かもしれない。

頼りないなあ……。

より大勢の方の救いを求める場合、ツクマテで質問してみるのも一つの手だな。いずれにせよ、一人で考えて分からない場合はガンガン聞いてしまえ!


You may also like...

コメントを残す

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です

日本語が含まれない投稿は無視されますのでご注意ください。(スパム対策)