コンテンツにスキップ

パッチバージョンをサーバーにアップロード

以前にSandboxまたはLive環境でCrossplay Launcherを使用してPCバージョンのアプリを配布した場合は、このアプリを更新するためにHiveコンソールのSandboxまたはProductionサーバーにパッチバージョンをアップロードする必要があります。

 

パッチバージョンをアップロードする主な方法は2つあります:

  1. パッチファイルのみをアップロード
  2. パッチファイルとアプリ全体のファイルを一緒にアップロード


パッチファイルのみをアップロードすることは、ユーザーがアプリをパッチファイルのみで更新することを意味します。この方法は、パッチファイルのサイズが大きくない場合に使用できます。しかし、この方法は、初期バージョンと最新バージョンの間に多くの中間バージョンがある場合に問題を引き起こす可能性があります（例：1.0.0.0、1.0.0.1、1.0.0.2、...、1.1.0.0）。Crossplay Launcherが中間バージョンを通じてバージョンを順次更新するため（例：1.0.0.0 → 1.0.0.1 → 1.0.0.2 → ... → 1.1.0.0）、パッチファイルのみでアプリを継続的に更新することは、アプリを初めてインストールするユーザーやアプリを再インストールするユーザーにとって時間がかかる場合があります。

パッチファイルとアプリ全体のファイルをアップロードすることは、ユーザーがアプリを再インストールして更新することを意味します。この方法は、アプリ全体のサイズが過度に大きくない場合や、中間バージョンが多い場合に使用できます。この場合、ユーザーがアプリを更新するのにかかる時間は、パッチファイルのみでアプリを更新するよりも短くなる可能性があります。

結局、どの方法を選択するかは、アプリファイルの総サイズ、中間バージョンの数、およびアプリパッチファイルのサイズなどの考慮事項に依存します。アプリ開発者は、アプリのインストールと更新に必要な時間を確認した後に選択すべきです。


パッチファイルの作成

どちらの方法でも、最初にパッチファイルを作成する必要があります。パッチメーカーを使用して、アプリの現在のバージョンと新しいバージョンの違いを分析し、パッチファイルを生成します。その後、アップローダーを使用してパッチファイルをHiveサーバーにアップロードします。新しいバージョンのアプリのファイルの合計サイズは、ディスク割り当てサイズに基づいて30GB未満でなければならず、新しいバージョンのアプリの各ファイルのサイズは4GB未満でなければなりません。

パッチメーカーとアップローダーは、GUIとCUIの2種類があります。開発環境に応じて、2つの方法のいずれかを選択してください。以下では、ゲームアプリのバージョンを更新する状況で、GUIまたはCUIパッチメーカーの使い方を案内します。


シナリオ

  • AppID: com.gcp2.stepbystep.windows.google.global.normal
  • Hive コンソールサーバーにアップロードする: LIVE
  • 前のアプリバージョン: 1.0.0.0
  • 前のバージョンアプリの場所: D:\myGame_v1_0_0_0
  • 最新のアプリバージョン: 1.0.0.1
  • 最新バージョンアプリの場所: D:\myGame_v1_0_0_1
  • パッチファイルを生成する場所: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1
Note

ウイルス対策プログラムを使用する際、そのリアルタイム保護（または監視）機能がプログラムのインストールやファイルの変更を検出し、パッチファイルの作成中にエラーを引き起こす可能性があります。パッチファイルの作成中にエラーが続く場合は、ウイルス対策ソフトウェアでパッチメーカーを信頼できるプログラムとして登録するか、ウイルス対策プログラムを閉じた後に再試行してください。


オプション 1: GUIを使用してパッチファイルを作成する

GUIパッチメーカーは、GUIインターフェースを通じてパッチファイルを作成します。

 

  1. こちらからCrossplay Launcherツールをダウンロードして解凍し、_GUI/patch_maker/CrossplayLauncherPatchFileMaker.exe_を実行します。
  2. パッチメーカーのインターフェースで、以下を入力して**開始**を押します:
    • 前のバージョンのパス: D:\myGame_v1_0_0_0
    • 現在のバージョンのパス: D:\myGame_v1_0_0_1
    • パッチファイルのパス: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1
    • 環境: サンドボックス環境にはSANDBOX、ライブ環境にはLIVE(REAL)を使用します
    • APP ID: com.gcp2.stepbystep.windows.google.global.normal
    • 前のバージョン: 1.0.0.0

オプション2: CUIを使用してパッチファイルを生成する

  1. Crossplay Launcherツールをダウンロードし、こちらから抽出します。
  2. Pre_Version_FolderとCur_Version_Folderフォルダーを、CUI/patch_maker/cpflPtc.exeがあるのと同じディレクトリに作成し、それぞれD:\myGame_v1_0_0_0とD:\myGame_v1_0_0_1からファイルをコピーします。

  3. CUI/patch_maker/cpflPtc.exeをWindowsターミナルまたはPowerShellで、以下のコマンドライン引数を使って実行します:

    • ‐‐prePath: D:\myGame_v1_0_0_0、デフォルトはPre_Version_Foler
    • ‐‐nextPath: D:\myGame_v1_0_0_1、デフォルトはCur_Version_Foler
    • ‐‐patchPath: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1、デフォルトはPatch_Files_Folder
    • -envi: サンドボックス環境はSANDBOX、ライブ環境はLIVE（バージョン1.0.0.0のアプリファイルがアップロードされた環境と同じである必要があります）
    • ‐‐appid: com.gcp2.stepbystep.windows.google.global.normal
    • ‐‐version: 前のバージョンを入力します、1.0.0.0
    • -runbatch: y（パッチ処理中に質問プロンプトをスキップするかどうか）
    
cpflPtc.exe \
‐‐prePath="D:\myGame_v1_0_0_0" \
‐‐nextPath="D:\myGame_v1_0_0_1" \
‐‐patchPath="D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1" \
-envi="LIVE" \
-appid="com.gcp2.stepbystep.windows.google.global.normal" \
-version="1.0.0.0" \
-runbatch="y"

生成されたパッチファイルを確認する

GUIまたはCUIパッチメーカーによって生成されたパッチファイルをPatch_Files_Folderで確認してください。ファイルパスが以前のバージョンと新しいバージョンで同じであってもファイルデータが異なる場合、パッチファイルが生成されます。以前のバージョンに存在しなかったファイルが新しいバージョンに追加された場合、Patch_Files_Folderの対応するファイルパスにファイルが作成されます。

オプション 1: パッチファイルのみのアップロード

生成されたパッチファイルを、Hive コンソールサンドボックスサーバーまたは Hive コンソールライブサーバーのいずれかにアップロードします。利用可能なアップローダーには、GUI と CUI の2種類があります。開発環境に応じて、これらの方法のいずれかを選択してパッチファイルをアップロードしてください。


オプション 1: GUIを使用してパッチファイルをアップロードする

GUIアップローダーは、グラフィカルインターフェースを介してアップロードします。

 

  1. Hive サンドボックスコンソールまたは Hive ライブコンソールに移動し、_クロスプレイランチャー > アプリ管理 > IPアップロード_を選択して、ゲームとAppIDを選択します。アプリファイルがアップロードされるPCのIPアドレスを代表IP（Rep IP）として登録します。
  2. クロスプレイランチャーツールをダウンロードし、こちらから抽出します。
  3. _GUI/uploader/CrossplayLauncherFileUploader.exe_を実行します。
  4. アップローダー画面で、以下を入力し、**開始**をクリックします:
    • アップロードフォルダパス: D:\myGame_v1_0_0_1
    • パッチフォルダパス: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1（パッチメーカーによって生成されたパッチファイルがあるパス）
    • 初回アップロードではない: チェック済み
    • 環境: サンドボックス環境はSANDBOX、ライブ環境はLIVE(REAL)（バージョン1.0.0.0のアプリファイルがアップロードされた環境と一致する必要があります）
    • プラットフォーム: Windows
    • リリースか: N
    • APP ID: com.gcp2.stepbystep.windows.google.global.normal
    • アプリバージョン: 1.0.0.1
  5. アップロードが成功すると、処理ウィンドウにステータスコード201が表示されます。

オプション2: CUIを使用したパッチファイルのアップロード

  1. サンドボックスコンソールまたは ライブコンソールから、Crossplay Launcher > アプリ管理 > IPをアップロードに移動し、ゲームとAppIDを選択します。アプリファイルがアップロードされるPCのIPアドレスを代表IP（Rep IP）として登録します。
  2. Crossplay Launcherツールをダウンロードし、こちらから抽出します。

  3. CUI/uploader/cpflupl.exeをWindowsターミナルまたはPowerShellで以下のコマンドライン引数を使用して実行します:

    • -envi: サンドボックス環境はSANDBOX、ライブ環境はLIVE（バージョン1.0.0.0のアプリファイルがアップロードされた環境と一致する必要があります）
    • ‐‐platform: w
    • ‐‐release: n
    • -notfirstupload: 適用可能（パッチファイルをアップロードする場合のみ、新しいアプリをアップロードする場合ではありません）
    • ‐‐appid: com.gcp2.stepbystep.windows.google.global.normal
    • ‐‐version: 1.0.0.1
    • ‐‐filepath: D:\myGame_v1_0_0_1
    • ‐‐filepatchpath: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1、デフォルトはtoUploadPatchFiles
    • -runbatch: 適用可能
    
cpflupl.exe \
‐‐appid="com.gcp2.stepbystep.windows.google.global.normal" \
‐‐platform="w" \
--version="1.0.0.1" \
-envi="LIVE" \
‐‐filepath="D:\myGame_v1_0_0_1" \
‐‐filepatchpath="D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1" \
-runbatch ‐‐notfirstupload ‐‐release="n"
  4. アップロードが成功すると、ターミナルまたはシェルにステータスコード201が表示されます。
Note

パッチファイルをアップロードする際、アップロードしようとしているバージョンが以前に配布されたバージョンと一致する場合（GUIではApp Version、CUIでは‐‐versionと呼ばれます）、アップロードプロセスは実行されません。


オプション2: パッチファイルとアプリ全体のファイルを一緒にアップロードする

作成したパッチファイルとアプリ全体のファイルを、Hive コンソールサンドボックスサーバーまたは Hive コンソールライブサーバーのいずれかにアップロードします。アップローダーには2種類あります: GUI と CUI。開発環境に応じて、これらの方法のいずれかを選択してパッチファイルとアプリ全体のファイルをアップロードしてください。

オプション 1: GUIを使用してパッチファイルとアプリの完全ファイルをアップロードする

GUIアップローダーはGUI画面を通じてアップロードします。

  1. ゲームとAppIDを、_Crossplay Launcher > App Management > Upload IP_の下にあるSandbox consoleまたはLive consoleで選択し、アプリファイルがアップロードされるPCのIPアドレスを代表IP（Rep IP）として登録します。
  2. こちらからCrossplay Launcherツールをダウンロードして解凍します。
  3. _GUI/uploader/CrossplayLauncherFileUploader.exe_を実行します。
  4. アップローダー画面で、以下の詳細を入力し、**開始**をクリックします:
    • アップロードフォルダパス: D:\myGame_v1_0_0_1
    • パッチフォルダパス: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1（パッチメーカーによって生成された*パッチファイルがあるディレクトリ）
    • 初回アップロードではない: チェック済み
    • 環境: サンドボックス環境の場合はSANDBOX、ライブ環境の場合はLIVE(REAL)（バージョン1.0.0.0のアプリファイルがアップロードされた環境と一致する必要があります）
    • プラットフォーム: Windows
    • リリースか: Y
    • APP ID: com.gcp2.stepbystep.windows.google.global.normal
    • アプリバージョン: 1.0.0.1
  5. アップロードが成功すると、処理ウィンドウにステータスコード201が表示されます。


オプション2: CUIを使用してパッチファイルとフルアプリファイルをアップロードする

  1. ゲームとAppIDを選択し、Crossplay Launcher > App Management > Upload IPの下の サンドボックスコンソールまたは ライブコンソールで、アプリファイルがアップロードされるPCのIPアドレスを代表IP（Rep IP）として登録します。
  2. こちらからCrossplay Launcherツールをダウンロードして抽出します。

  3. CUI/uploader/cpflupl.exeをWindowsターミナルまたはPowerShellで以下のコマンドライン引数を使用して実行します:

    • -envi: サンドボックス環境はSANDBOX、ライブ環境はLIVE（バージョン1.0.0.0のアプリファイルがアップロードされた環境と一致する必要があります）
    • ‐‐platform: w
    • ‐‐release: y
    • -notfirstupload: 適用可能（パッチファイルをアップロードする場合のみ、新しいアプリをアップロードしない場合）
    • ‐‐appid: com.gcp2.stepbystep.windows.google.global.normal
    • ‐‐version: 1.0.0.1
    • ‐‐filepath: D:\myGame_v1_0_0_1
    • ‐‐filepatchpath: D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1、デフォルトはtoUploadPatchFiles
    • -runbatch: 適用可能
    
cpflupl.exe \
‐‐appid="com.gcp2.stepbystep.windows.google.global.normal" \
‐‐platform="w" \
--version="1.0.0.1" \
-envi="LIVE" \
‐‐filepath="D:\myGame_v1_0_0_1" \
‐‐filepatchpath="D:\PATCH_myGame_v1_0_0_0_myGame_v1_0_0_1" \
-runbatch ‐‐notfirstupload ‐‐release="n"
  4. アップロードが成功すると、ターミナルまたはシェルにステータスコード201が表示されます。
Note

パッチファイルをアップロードする際、アップロードしようとしているバージョンが以前に配布されたバージョン（GUIではApp Version、CUIでは‐‐versionと呼ばれます）と一致する場合、アップロードプロセスは実行されません。


アップロード結果の確認

アップロードが完了したら、Hive コンソール > クロスプレイランチャー > アプリ管理 > ダウンロード設定に移動して、アプリが正常にアップロードされたことを確認してください。