言語を切り替える
テーマを切り替える

Cocos Creator WeChatミニゲームビルド完全ガイド:Buildパネルから開発者ツールまで

数週間かけて、ついにCocos Creatorでゲームを完成させました。

コードは書き終わり、素材はインポートし、アニメーションも動いています。さてBuildパネルを開いてWeChatミニゲームプラットフォームに公開しようとしたら、ここからが本当の始まりだと気づきます。

libVersionフィールドエラー。実機で黒画面。パッケージサイズ超過。iOSビルドが失敗。これらの問題はどれもゲーム開発チュートリアルには載っていませんが、どれもプロジェクトを公開段階で止めてしまう原因になります。

この記事では、これらの問題を解決します。Buildパネルの各パラメータの設定方法から、ビルド出力ディレクトリのファイルの役割、WeChat開発者ツールでの実機デバッグの具体的な手順まで、全プロセスを詳しく解説します。最後に2026年のWeChatミニゲームインセンティブ政策も解説します。公開成功後、収益をどう最大化するかも事前に計画しておきましょう。

CocosプロジェクトをWeChatミニゲームプラットフォームに公開する準備をしている方や、既に問題に遭遇して解決策を探している方に、このガイドがお役に立てるはずです。

Buildパネルパラメータ設定の実践

まずBuildパネルを開きます。

Cocos Creatorで、2つの方法があります。メニューバーで「プロジェクト → ビルド公開」をクリックするか、ショートカットキーCtrl+Shift+Bを押します(MacではCmd+Shift+B)。パネルが開くと、多数のパラメータが表示されます。公開パスから初期シーン、MD5 CacheからAppIDまで、初めて見ると少し戸惑うかもしれません。

でも慌てず、一つずつ解説します。

共通パラメータ:基本設定

公開パス:ビルド出力ディレクトリの場所。デフォルトではプロジェクトルートディレクトリにbuildフォルダが生成されます。別のパスに変更できますが、デフォルトを維持することをお勧めします。これによりビルド出力のディレクトリ構造が固定され、後のデバッグも探しやすくなります。

初期シーン:ゲーム起動時に最初に読み込まれるシーン。通常はBootシーンまたはLoadingシーンを選択します。プロジェクトに複数のエントリがある場合は、メインエントリを選択してください。

ビルド対象シーン:ここにはプロジェクト内のすべてのシーンがリストされます。パッケージに含めるシーンにチェックを入れます。チェックしないシーンは最終パッケージに含まれません。よくある問題として、すべてのシーンにチェックを入れてパッケージサイズが爆発するケースがあります。本当に必要なシーンだけにチェックを入れ、他のシーンはリモートリソースサーバーに置くことをお勧めします。

MD5 Cache:このオプションを有効にするべきか?

有効にすると、すべてのリソースファイル名にMD5サフィックスが追加されます。メリットは、リソース更新時にクライアントが自動的にファイルの変更を検出し、古いキャッシュの読み込みを回避できることです。デメリットは、コード内のリソースアクセス方法を変更する必要があることです。

例えば、元々resources.load('texture/hero')を使っていた場合、MD5 Cacheを有効にするとURLはtexture/hero-abc123.pngのようになります。この場合、次の方法で正しいURLを取得する必要があります。

// MD5サフィックス付きのリソースパスを取得
const url = assetManager.utils.getUrlWithUuid('texture/hero', {
    isScene: false,
    type: 'png'
});

このAPIはCocos Creator 3.xの標準的な使い方です。2.xを使用している場合はロジックが少し異なりますが、核となる考え方は同じです。リソースパスをハードコードせず、エンジンに処理させましょう。

WeChatミニゲーム専用パラメータ:プラットフォーム設定

AppID:これは必須です。

AppIDがない場合、ビルドボタンをクリックするとエラーになります。テスト用のAppIDを使用できますが、テスト用IDには多くの機能制限があります。オープンデータ領域が使えない、公開できない、広告収益化機能も制限されるなどです。

AppIDの申請フロー:WeChat公衆プラットフォームにログイン → ミニプログラム管理 → ミニゲームを追加 → AppIDを取得。全プロセスに1〜3日の審査時間が必要なので、事前に準備することをお勧めします。

デバッグモード:ビルド出力にデバッグ関連のコードとリソースが追加されます。正式公開時は無効にすることをお勧めしますが、開発段階では有効にしておくとデバッグ時間を大幅に短縮できます。

エンジン分離:このオプションはパッケージサイズを大幅に削減できます。

有効にすると、Cocosエンジンコードはゲーム本体にパッケージングされず、WeChatのサーバーから読み込まれます。エンジン分離を有効にする前提条件は次のとおりです。

  • Debug Base Libraryバージョン ≥ 2.9.0(WeChat開発者ツールで設定)
  • WebAssembly機能にはWeChatクライアントバージョン ≥ v7.0.17が必要

エンジン分離のメリット:最初のパッケージを4MB以下に抑えられます。デメリット:エンジンの読み込みに時間がかかり、プレイヤーが初めてゲームに入る際に短い待ち時間が発生します。プロジェクトのリソースが多い場合、エンジン分離はほぼ必須です。

サブドメイン設定:ランキング、友達シェアなどのオープンデータ領域機能を使用する場合、サブドメインの関連情報を設定する必要があります。サブドメインは独立した実行環境で、メインゲームと分離され、ソーシャルデータを処理します。設定が不適切だとランキング機能が動作しなくなります。

見落としやすいポイント

ビルドパネルの下部に「ビルド」ボタンがあり、その横に「生成」ボタンがあります。

多くの人が「ビルド」をクリックして終わったと思いがちです。実は「ビルド」はビルド出力ディレクトリを作成するだけで、最終的なコードパッケージングはまだ行っていません。「生成」をクリックしてはじめて完全なパッケージングフローが実行され、WeChatミニゲームに必要なgame.jsgame.jsonなどのエントリファイルが生成されます。

初めて公開した時、私は「ビルド」をクリックしてWeChat開発者ツールでプロジェクトをインポートしに行きましたが、エラーが出ました。エントリファイルが見つかりません。原因は「生成」をクリックしていなかったことです。この小さな詳細は公式ドキュメントに書いてありますが、見落としやすいです。

ビルド出力の解析とよくある落とし穴リスト

ビルドが完了したら、プロジェクトルートディレクトリのbuildフォルダを見てみましょう。

その中にwechatgameディレクトリがあります。これがWeChatミニゲームプラットフォームのビルド出力です。このディレクトリを開くと、多くのファイルとフォルダが見えます。いくつかはCocosが生成したもの、いくつかはWeChatミニゲーム特有の設定です。それぞれの役割を見ていきましょう。

重要設定ファイルの解読

game.js:エンジン起動エントリ。

WeChatミニゲームプラットフォームがゲームを読み込む際、最初に実行するのがこのファイルです。Cocosエンジンの初期化コード、シーン読み込みロジックが含まれています。このファイルを手動で変更する必要はありませんが、ビルドに問題がある場合は、ここに構文エラーがないか確認できます。

game.json:グローバル設定ファイル。

{
    "deviceOrientation": "portrait",
    "networkTimeout": {
        "request": 60000,
        "connectSocket": 60000,
        "uploadFile": 60000,
        "downloadFile": 60000
    },
    "enginePlugins": [
        "cocos"
    ],
    "optimization": {
        "render": true,
        "fps": true
    }
}

主要なフィールドの説明:

  • deviceOrientation:画面方向、portraitは縦画面、landscapeは横画面
  • networkTimeout:ネットワークリクエストのタイムアウト時間(ミリ秒単位)
  • enginePlugins:エンジンプラグイン設定、エンジン分離を有効にすると"cocos"が表示されます
  • optimization:パフォーマンス最適化オプション、renderfpsはデフォルトで有効

project.config.json:WeChat開発者ツールのプロジェクト設定。

{
    "miniprogramRoot": "./",
    "setting": {
        "urlCheck": false,
        "es6": true,
        "postcss": true,
        "minified": true
    },
    "compileType": "game",
    "libVersion": "2.25.0",
    "appid": "wx1234567890abcdef",
    "projectname": "my-game"
}

ここに落とし穴があります。libVersionフィールドです。

落とし穴リスト:よくある5つの問題

落とし穴1:libVersionフィールド無効

症状:WeChat開発者ツールでエラーが発生、基本ライブラリバージョンが無効というメッセージが表示される。

原因:Cocosがビルド時に自動生成するlibVersionフィールドが、WeChatプラットフォームで現在サポートされているバージョン番号と一致しない可能性があります。例えば、ビルド出力が"2.25.0"でも、WeChat開発者ツールには"2.20.3"または"latest"オプションしかない場合があります。

解決策:project.config.jsonを手動で編集し、libVersion"widelyUsed"または"latest"に変更します。

{
    "libVersion": "widelyUsed"
}

widelyUsedはWeChatプラットフォームが推奨する安定版で、互換性が最も良いです。latestは最新版で、機能は多いですが新しい問題があるかもしれません。まずwidelyUsedを使い、安定してからlatestを試すことをお勧めします。

落とし穴2:self is not defined

症状:ビルドは成功したが、実機実行時にself is not definedエラーが発生。

原因:プロジェクトでsocket.ioライブラリを使用している。WeChatミニゲーム環境にはwindow.selfというグローバルオブジェクトがなく、socket.ioの一部バージョンがこれにアクセスしようとする。

解決策:socket.io v1.4.4を使用する。

npm install [email protected] --save

v1.4.4はWeChatミニゲーム環境と互換性のある最後の安定版です。それ以降のバージョンは多くのリファクタリングが行われましたが、selfへの依存が導入されています。高バージョンのsocket.ioを使用する必要がある場合は、ソースコードを手動でパッチし、selfwindowまたはglobalに変更する必要があります。

落とし穴3:循環参照JSONエラー

症状:ビルド時にエラーが発生し、あるJSONファイルで循環参照があると表示される。

原因:コード内のグローバルオブジェクトが誤ってシリアライズされた。例えばwindow.globalに複雑なオブジェクトが保存され、ビルド時にCocosがこれをJSONに変換しようとして、オブジェクト内部に循環参照が見つかった場合。

解決策:window.globalの初期化ロジックを確認する。

// 誤った書き方:グローバルオブジェクトに自身への参照を保存
window.global = {
    self: window.global  // 循環参照
};

// 正しい書き方:自己参照を避ける
window.global = {
    config: {},
    gameState: {}
};

ビルド前にこのような循環参照を削除してください。複雑なオブジェクトを保存する必要がある場合は、JSON.stringifyJSON.parseを使って手動でシリアライズし、循環参照部分をスキップできます。

落とし穴4:エンジン分離後MiniGameCenter消失

症状:エンジン分離を有効にし、ビルドは成功したが、WeChat開発者ツールでMiniGameCenter関連機能が見つからない。

原因:MiniGameCenterはWeChatミニゲームのサービスコンポーネントで、エンジンコードに依存している。エンジン分離後、MiniGameCenterの一部機能が動作しなくなる。

解決策:一時的にエンジン分離を無効にする。

MiniGameCenterの完全な機能(広告テスト、アプリ内課金など)が必要な場合は、まずエンジン分離オプションを無効にし、エンジンコードを最初のパッケージに含めます。機能テストが完了し、正式公開前にエンジン分離を有効にするかどうかを検討してください。

落とし穴5:iOSビルド失敗

症状:iOSプラットフォーム版をビルドする際にエラーが発生し、ある依存ライブラリまたはリソースファイルが見つからないと表示される。

原因:iOSビルドフローはWeChatミニゲームより複雑で、いくつかの条件を確認する必要がある。

  • Xcodeバージョンが一致しているか(Xcode 12以上を推奨)
  • 依存ライブラリのパスが正しいか(PodfileまたはCarthage設定を確認)
  • リソースファイルが完全か(特に画像、音声ファイル)

解決策:

  1. Xcodeを開き、ビルドログを確認して具体的なエラー情報を見つける
  2. Podfileの依存ライブラリバージョンとローカルにインストールされたバージョンが一致しているか確認
  3. ビルドキャッシュをクリア:rm -rf build/ios、再ビルド

iOSビルドの問題は多岐にわたるため、具体的なエラーごとに分析が必要です。しかし、多くの場合、キャッシュをクリアして再ビルドすれば解決します。

パッケージサイズ制限:どう制御するか

WeChatミニゲームには2つのパッケージサイズ制限があります。

  • 最初のパッケージ制限:4MB
  • 総パッケージ制限:20MB(最初のパッケージ + サブパッケージ)

制限を超えたらどうするか?

方法1:リソースリモート化

大部分の画像、音声をリモートサーバーに置き、最初のパッケージにはコードと必要な小さなリソースだけを含める。CocosのassetManagerはリモートURLからのリソース読み込みをサポートしています。

assetManager.loadRemote('https://your-server.com/assets/hero.png', (err, texture) => {
    if (err) {
        console.error('リソース読み込み失敗', err);
        return;
    }
    // 読み込んだリソースを使用
});

リモートリソース読み込みには問題があります。初回読み込みに時間がかかり、プレイヤー体験に遅延が発生します。最もよく使うリソースは最初のパッケージに残し、あまり使わないものはリモートに置くことをお勧めします。

方法2:サブパッケージ読み込み

WeChatミニゲームはサブパッケージをサポートしています。ゲームをいくつかのモジュールに分割し、各モジュールを1つのサブパッケージとします。プレイヤーがあるシーンに入った時、対応するサブパッケージが読み込まれます。

// game.jsonでサブパッケージを設定
{
    "subpackages": [
        {
            "name": "level-1",
            "root": "subpackages/level-1"
        },
        {
            "name": "level-2",
            "root": "subpackages/level-2"
        }
    ]
}

サブパッケージ読み込みにはCocosのビルドフローの追加設定が必要です。具体的な手順はCocos公式ドキュメントの「サブパッケージビルド」の章を参照してください。

WeChat開発者ツールデバッグ実践

ビルドが完了したら、次はWeChat開発者ツールに入ります。

多くの人がこの段階で間違いを犯します。「新規プロジェクト」をクリックして、間違ったディレクトリを選択してしまいます。正しい方法は「プロジェクトをインポート」をクリックし、Cocosビルド出力のbuild/wechatgameディレクトリを選択することです。

インポート後、プロジェクト設定画面が表示されます。重要な設定をいくつか解説します。

基本ライブラリバージョン設定

右上に「詳細」ボタンがあり、クリックすると「ローカル設定」タブが見えます。

その中に「デバッグ基本ライブラリ」ドロップダウンがあります。ここでwidelyUsedまたはlatestを選択する必要があります。これは先ほどproject.config.jsonを編集した時と同じです。存在しないバージョン番号を選択すると、ツールがエラーを表示します。

合法ドメインを検証しない

テスト段階では、リソースサーバーのドメインがまだWeChat公衆プラットフォームでICP登録されていないかもしれません。この場合、「合法ドメイン、web-view(ビジネスドメイン)、TLSバージョン、HTTPS証明書を検証しない」オプションにチェックを入れます。

チェックを入れると、ツールは未登録ドメインのリクエストをブロックしません。ただし、正式公開前にはドメインをホワイトリストに追加してください。そうしないとプレイヤーはリモートリソースを読み込めません。

実機デバッグフロー

ツールバーの「実機デバッグ」ボタンをクリックします。

WeChat開発者ツールv1.05以上では、実機デバッグv2機能が提供されています。旧バージョンと比較して、v2にはいくつかの改善があります。

  1. QRコードプレビューがより安定
  2. リモートデバッグとChrome DevToolsのシームレスな統合
  3. ブレークポイントデバッグ、パフォーマンス監視の同期表示をサポート

具体的なフロー:

  1. 「実機デバッグ」をクリックしてQRコードを生成
  2. スマートフォンでWeChatを開き、QRコードをスキャンしてデバッグモードに入る
  3. ツール画面の右側にデバッグパネルが表示され、Chrome DevToolsと同じ

デバッグパネルにはいくつかのよく使う機能があります。

  • Console:ログ出力を確認、console.logの内容がリアルタイムで表示される
  • Sources:ソースコードを確認、ブレークポイント設定をサポート
  • Network:ネットワークリクエストを確認、リソース読み込みが成功したかチェック
  • Memory:メモリ分析ツール、メモリリークがないか確認

実機デバッグはエミュレータデバッグよりリアルです。エミュレータでのパフォーマンスと実機では大きな差があります。特に低スペックAndroid端末では差が顕著です。複数回実機デバッグを実行し、異なる端末をカバーすることをお勧めします。

パフォーマンス監視ツール:使い方

WeChat開発者ツールには完全なパフォーマンス監視ツールセットがあります。

「開発ツールボックス」ボタン(ツールバーの右側)をクリックすると、診断パネルが開きます。いくつかのコア機能があります。

実機パフォーマンス監視

QRコードをスキャンした後、スマートフォンでゲームを実行すると、ツールがリアルタイムでFPS、メモリ、CPUデータを表示します。

データはグラフ形式で表示されます。直感的に確認できます。

  • FPSが安定しているか(60FPSが理想、30FPS以下は明らかなカクつきがある)
  • メモリが継続的に増加していないか(ずっと増えている場合、メモリリークがある)
  • CPU使用率が高すぎないか(50%を超えると計算負荷が大きい)

初回画面レンダリング分析

「初回画面レンダリング」オプションをクリックすると、ツールがゲーム起動から初回画面が完全に表示されるまでの時間を記録します。

このデータは非常に重要です。プレイヤーが3秒以上待つと、離脱率が明らかに上昇します。初回画面レンダリング時間が3秒を超える場合、最適化が必要です。

  • 初回画面のリソース数を減らす
  • より小さい画像サイズを使用する
  • 必須ではないリソースを初回画面以降に読み込む

読み込みパフォーマンス分析

ツールはすべてのリソース読み込み時間をリストします。どのリソースの読み込みが最も遅いかを確認し、重点的に最適化できます。

例えば、2MBのPNG画像が500msで読み込まれた場合、次の方法を検討できます。

  • WebP形式に変換(サイズが30%-50%削減)
  • 画像解像度を圧縮
  • キャッシュにプリロード

ランタイムパフォーマンス分析

この機能はゲーム実行中のパフォーマンスボトルネックを記録します。

例えば、あるシーン切り替え時にFPSが突然低下した場合、ツールは低下の原因をマークします。あるアニメーションの計算量が大きすぎるのか、あるスクリプトの実行時間が長すぎるのかなど。

高性能モード:iOS特化最適化

iOS端末では、WeChatミニゲームに「高性能モード」があります。

有効にすると、ゲームは独立したプロセスで実行され、WeChatクライアントとプロセスを共有しません。メリットは、CPUとメモリリソースがより独立しており、パフォーマンスが明らかに向上することです。

公式テストデータ:iPhone 11 Pro Maxで、水族館デモのFPSが13から49に向上。この向上幅は非常に大きいです。

有効化方法

  1. WeChat公衆プラットフォームにログイン
  2. 「生産効率化パッケージ」管理ページに入る
  3. iOS高性能モードサービスを開通

開通後、game.jsonに設定を追加します。

{
    "iOSHighPerformance": true
}

メモリ制限に注意

高性能モードには追加のメモリ制限があります。

  • 2GB RAMの端末(iPhone 8、iPhone 7)、制限1GB
  • 3GB RAMの端末(iPhone 11、iPhone 12)、制限1.4GB

制限を超えるとメモリ警告が発生し、クラッシュすることさえあります。ゲームのリソースが多い場合は、メモリピークを制御する必要があります。

実測の推奨:

  • 高性能モードを有効にすると、FPSは明らかに向上するが、メモリ使用量も増加する
  • 低スペック端末(iPhone 8)では、リソースを800MB以下に抑えるのが安全
  • 高スペック端末(iPhone 12)では、1.2GBまで緩和可能

高性能モードを有効にした後、必ず実機パフォーマンス監視を実行し、FPSとメモリが安全な範囲内にあることを確認してください。

2026 WeChatミニゲーム政策解説

ゲームが公開されたら、次は運営と収益です。

2026年、WeChatミニゲームは新しいインセンティブ政策を導入しました。開発者にとって良いニュースです。核心的な条項を簡単に解説します。

IAP(アプリ内課金収益化)インセンティブ新政

ゲームでアプリ内課金収益化を採用する場合、初回公開期に追加インセンティブがあります。

インセンティブ比率:100%以上

具体的な構成:

  • 基本分成:70%(開発者が70%、WeChatプラットフォームが30%)
  • 初回公開インセンティブ:追加40%

合計すると、初回公開期に開発者が実際に受け取る比率は70% + 40% = **110%**です。そうです、売上より10%多いです。

このインセンティブ政策には時間枠があります。初回公開新ゲーム期間、最初の1000万売上まで110%のインセンティブを受けられます。1000万を超えると、基本の70%に戻ります。

インセンティブ金上限:400万元(2026年上半期)

1つのゲームは初回公開期に最大400万元のインセンティブ金を受け取れます。ゲームの売上が1000万を突破した場合、インセンティブ金は比率で計算:1000万 × 40% = 400万。ちょうど上限です。

初回成長インセンティブ:売上が200万に達するごとに、追加5%の現金

これは初回公開インセンティブに上乗せされます。例えば、ゲームの初回公開期の売上が600万に達した場合:

  • 基本分成:600万 × 70% = 420万
  • 初回公開インセンティブ:600万 × 40% = 240万(上限400万以内、超過なし)
  • 成長インセンティブ:600万 ÷ 200万 = 3回、各5%、合計600万 × 15% = 90万

合計:420 + 240 + 90 = 750万

比較してみましょう:インセンティブ政策がない場合、600万売上では420万しか受け取れません。政策が加わると、330万多く受け取れます。

IAA(広告収益化)インセンティブ新政

ゲームで広告収益化(IAA)を採用する場合も、インセンティブ政策があります。

軽量IAAゲーム:30日間売上40%インセンティブ金

軽量ゲームとは、カジュアル、パズル、マッチ3など、プレイがシンプルなゲームを指します。このタイプのゲームはユーザー数が多いですが、1人あたりの課金意欲は低く、広告収益化に適しています。

インセンティブ計算方法:公開後30日以内、広告売上 × 40%がインセンティブ金として支払われます。

中重度IAAゲーム:90日間売上35%インセンティブ金

中重度ゲームとは、アクション、RPG、ストラテジーなど、プレイが複雑なゲームを指します。このタイプのゲームはユーザー数が相対的に少ないですが、1人あたりのアクティブ時間が長く、広告表示回数が多いです。

インセンティブ計算方法:公開後90日以内、広告売上 × 35%。

収益最大化戦略

政策条項は理解できました。では、どうやって収益を最大化するか?

初回公開タイミングの計画

初回公開インセンティブ期間は最初の1000万売上までしか適用されません。ゲームのポテンシャルが大きい場合、ユーザーアクティビティが高い時期(例えば冬休み、夏休み、祝日)に初回公開を設定することをお勧めします。これによりインセンティブ期間内に売上を迅速に伸ばせます。

例えば:

  • 通常時期の初回公開:インセンティブ期間内売上500万、インセンティブ金200万
  • 冬休み時期の初回公開:インセンティブ期間内売上1000万、インセンティブ金400万(上限)

倍の差があります。

売上ペース制御

インセンティブ金は売上比率で支払われます。ゲームの売上が急速に伸びると、インセンティブ期間がすぐに終わってしまいます。段階的なプロモーションを検討できます。

  1. 初回公開期:小規模プロモーション、ユーザーフィードバックをテスト
  2. インセンティブ期間内:大規模プロモーション、売上を迅速に伸ばす
  3. インセンティブ期間後:安定運営、コストを制御

これにより、インセンティブ期間内に売上を最大化しながら、プロモーションコストが高くなりすぎるのを防げます。

収益化モデルの選択

アプリ内課金収益化か広告収益化か?

  • プレイがシンプル、ユーザー数が多い:広告収益化が適切、軽量IAAインセンティブ40%
  • プレイが複雑、ユーザー課金意欲が高い:アプリ内課金収益化が適切、初回公開インセンティブ110%

一部のゲームはハイブリッド収益化が可能:アプリ内課金がメイン、広告は補助。WeChatプラットフォームもハイブリッド収益化モデルをサポートしており、インセンティブ政策はそれぞれ計算されます。

審査資格リスト

公開前に、これらの資格を準備してください。

  • ソフトウェア著作権:ソフトウェア著作権証明書、ゲームコードの著作権帰属を証明
  • ICP登録:ドメイン登録、ゲームにリモートリソースサーバーがある場合
  • 版号:オンラインゲーム出版物番号、正式上架に必須(ミニゲームは現在「試運営」資格で先行可能、版号は後で追加)
  • プライバシーポリシー:ゲーム起動時にプライバシーポリシーを表示、ユーザー同意後にのみ入場可能
  • 未成年者防止沉迷:実名認証、ゲーム時間制限、課金上限

これらの資格の申請期間:

  • ソフトウェア著作権:1〜2ヶ月
  • ICP登録:1〜2週間
  • 版号:3〜6ヶ月(最長)
  • 防沉迷機能:開発1〜2週間、WeChat公式APIと連携

事前に計画することをお勧めします。版号の申請期間が最も長いため、ゲーム開発段階から準備を始められます。

政策情報はWeChat公式コミュニティの2026年インセンティブ政策ドキュメントから。具体的な条項は変更される可能性があるため、公開前にWeChat公衆プラットフォームで最新版を確認することをお勧めします。

最後に

Cocos CreatorでWeChatミニゲームを公開するフローは短くありませんが、分解して見ると各ステップに法則があります。

Buildパネルパラメータ:AppIDは必須、MD5 Cache有効後のURL変換、エンジン分離の前提条件、ビルドと生成の違い。

ビルド出力ディレクトリ:game.jsgame.jsonproject.config.jsonそれぞれの役割。落とし穴リストの5つの問題(libVersion無効、self未定義、循環参照、MiniGameCenter消失、iOSビルド失敗)にはそれぞれ対応する解決策があります。

WeChat開発者ツールデバッグ:プロジェクトインポート、基本ライブラリバージョン設定、実機デバッグ、パフォーマンス監視。iOS高性能モードはFPSを大幅に向上できますが、メモリ制限に注意が必要です。

2026年インセンティブ政策:アプリ内課金初回公開110%、インセンティブ上限400万、広告収益化35%-40%。初回公開タイミング、売上ペース、収益化モデル、この3点を計画すれば、収益は倍増します。

公開準備中の方は、この順序で進めてください。

  1. Build設定を確認、パラメータ説明に従って一つずつ確認
  2. ビルド完了後、落とし穴リストで問題をチェック
  3. 実機デバッグを数回実行、FPSとメモリを監視
  4. 公開前に資格を準備、初回公開タイミングを計画してインセンティブ収益を最大化

WeChatミニゲームプラットフォームの政策と技術詳細は頻繁に更新されます。この記事は2026年上半期の公式ドキュメントと実戦経験に基づいており、今後更新される可能性があるため再確認が必要です。しかし、核心となるビルドフローとデバッグ方法は基本的に安定しています。

質問があればコメント欄でお気軽にどうぞ。

Cocos Creator WeChatミニゲーム公開フロー

ビルド設定から実機デバッグまでの完全操作手順

⏱️ 目安時間: 60 分

  1. 1

    ステップ1: Buildパネルパラメータを設定

    AppIDを入力(必須)、初期シーン設定、ビルド対象シーン選択、MD5 Cacheとエンジン分離オプションを設定。エンジン分離にはDebug Base Library ≥ 2.9.0が必要。
  2. 2

    ステップ2: ビルドと生成を実行

    「ビルド」をクリックして出力ディレクトリを生成し、次に「生成」をクリックしてgame.js、game.jsonなどのエントリファイルを作成。両方の手順が必要、そうしないとWeChat開発者ツールでインポートエラーになります。
  3. 3

    ステップ3: ビルド出力を確認

    build/wechatgameディレクトリを開き、game.js、game.json、project.config.jsonの設定が正しいか確認。libVersionを'widelyUsed'または'latest'に変更してバージョン無効エラーを回避。
  4. 4

    ステップ4: WeChat開発者ツールにインポート

    「プロジェクトをインポート」をクリック(新規作成ではない)、build/wechatgameディレクトリを選択。デバッグ基本ライブラリを'widelyUsed'に設定、テスト用に「合法ドメインを検証しない」にチェック。
  5. 5

    ステップ5: 実機デバッグとパフォーマンス監視

    実機デバッグv2でQRコードをスキャンしてプレビュー、Consoleログ、Networkリクエスト、Memory分析を確認。「開発ツールボックス」をクリックしてFPS、初回画面レンダリング時間、リソース読み込みパフォーマンスを確認。

FAQ

ビルド後、WeChat開発者ツールで「エントリファイルが見つかりません」エラーが出る場合は?
原因は「ビルド」だけクリックして「生成」をクリックしていないこと。ビルドは出力ディレクトリを作成するだけで、生成がgame.jsなどのエントリファイルを作成します。両方の手順が必要です。
libVersionフィールドエラーはどう解決しますか?
project.config.jsonのlibVersionを'widelyUsed'(安定版)または'latest'(最新版)に変更。Cocosが自動生成するバージョン番号がWeChatプラットフォームと一致しない場合があります。
実機実行で「self is not defined」エラーが出る原因は?
プロジェクトでsocket.ioの高バージョンを使用している場合、WeChatミニゲーム環境にはwindow.selfグローバルオブジェクトがありません。解決策:[email protected]に変更するか、手動でソースコードをパッチ。
パッケージサイズが4MB制限を超えないようにするには?
2つの方法:1) リソースリモート化 - assetManager.loadRemoteでリモートリソースを読み込み;2) サブパッケージ読み込み - game.jsonでsubpackagesを設定してシーンごとに分割。
iOS高性能モードの有効化方法と制限は?
WeChat公衆プラットフォームでサービスを開通後、game.jsonに"iOSHighPerformance": trueを追加。制限:2GB RAM端末はメモリ制限1GB、3GB RAM端末は制限1.4GB、超過するとクラッシュします。
2026年のWeChatミニゲームインセンティブ政策は?
アプリ内課金初回公開期は分成110%(基本70%+インセンティブ40%)、インセンティブ上限400万元;軽量IAAゲームは30日間売上40%インセンティブ;中重度IAAゲームは90日間売上35%インセンティブ。

10 min read · 公開日: 2026年5月22日 · 更新日: 2026年5月25日

関連記事

コメント

GitHubアカウントでログインしてコメントできます