更新とトラブル対処

よくある問題は、ダウンロードと更新の FAQ または起動と接続の FAQ をご覧ください。

ソフトウェアの更新

正式版は起動時にバックグラウンドで更新を確認します。設定のソフトウェア更新から説明を確認し、ダウンロードできます。既定では検証成功後に自動で再起動してインストールしますが、この設定は無効にできます。インストールに失敗した場合は旧版への復元を試みます。

1.3.4.0 は正式公開済みです。新しいクライアントは GGEA のソースコードリポジトリで更新を確認します。旧クライアントは引き続き GGEA-Release に接続し、移行用パッケージで更新できます。インストール後はメインリポジトリへ自動的に切り替わります。両リポジトリの移行用パッケージは同一のバイト内容で、旧バージョンも引き続き利用できます。接続できない場合は後で再試行してください。手動ダウンロードは正式リリースの公開状況を確認してください。

起動できない

すべてのファイルを展開したか、フォルダーに書き込めるか、VC++ v14 x64 ランタイムが正しくインストールされているかを確認します。EXE だけをコピーしないでください。

デバイスが見つからない

ADB のパス、エミュレーターのデバッグ設定、ゲームサーバー、対象インスタンスを確認します。エミュレーターの接続も参照してください。

不具合の報告

GitHub Issues に次の情報を添えてください。

エミュレーター名、バージョン、スクリーンショットの解像度。
実行したタスク、期待した動作、実際の動作。
問題発生前後の、機密情報を除いたログ。

アカウントの認証情報や個人設定一式は送信しないでください。

バックアップと認識の確認

更新前に config/、独自の AP プラン、座標、テンプレートをバックアップします。新しいパッケージで自分の設定を直接上書きせず、検証用に元の ZIP も保管してください。

アカウント欄の接続済み表示は ADB がオンラインであることだけを示し、ゲームアカウントの状態確認を意味しません。
画像認識には同梱の OpenCvSharp ネイティブライブラリが必要です。OpenCvSharpExtern.dll を移動・削除しないでください。
Microsoft.ML.OnnxRuntime.NativeMethods の初期化エラーでは、まず VC++ x64 ランタイムをインストールまたは修復し、アプリを再起動してください。改善しない場合は、対応バージョンのパッケージをすべて展開し直し、onnxruntime.dll と resources/common/ocr/ を残します。診断ログには内部例外とエラーコードが記録されます。外側の例外だけでランタイム不足と判断しないでください。
デイリーミッション報酬の受け取りは通信とアカウント同期の状態に依存します。本人確認、データ同期、ダウンロード確認がある場合は起動処理を中止します。
ADB とゲーム画面は利用者の環境で正しく設定する必要があります。ゲーム更新、アカウント状態の違い、古いテンプレートによって自動操作が停止する場合があります。

ショップ確認の原画像と診断メモはプログラムフォルダーの logs/shop、ホーム画面の認識資料は logs/recognition に保存します。開発用スキャン・位置検証ツールの画像と JSON はプロジェクトの logs/captures に保存します。旧フォルダーの資料は自動移行しません。MuMu のスクリーンショット転送用一時ファイルは読み取り後に削除し、認識テンプレートは resources/common/templates に保存します。