2023.2 での変更点
注釈：本資料はAI技術を用いて翻訳されています。
全般的な更新
バージョン命名
このリリースでは、ADT のバージョニング方法を変更しています。今後のリリースは、年（2023）とその年の中でのリリース番号（この場合はその年の 2 番目のリリース）に基づいて番号付けされます。
コンポーネントバージョン
AccelByte Development Toolkit (ADT) リリースバージョン 2023.2 には、以下のコンポーネントバージョンが含まれています。
- ADT Web Portal v1.24.0
- ADT Hub v0.20.0
- ADT SDK v2.25.0
- ADT CLI v2.15.0
Unreal Engine 5.2 サポート
ADT は 5.2 をサポートするように更新中です。完全なサポートは 2023.2 には含まれませんでしたが、近日中にパッチ更新をリリースする予定です。
配信の更新
Smart Builds ベータ版
Smart Builds が Alpha から Beta へ移行しました。これは、Smart Builds が本番環境での使用にほぼ対応できる段階に達したことを意味しますが、まだ解決すべき不具合が残っている可能性があります。現在はすべてのプラットフォームで使用できますが、現時点ではその利点を確認できるのは Unreal 4 または 5 の Windows のみです。コンソールプラットフォームと Unity のサポートは今年後半に追加される予定です。日々の作業で Smart Builds を使い始めることを推奨しますが、重要な用途での使用には注意してください。不具合や問題を見つけた場合は、すぐにご報告ください。
Smart Builds は、ADT におけるビルド配信の未来を象徴するものです。コンテンツを認識した差分検出（diffing）メカニズムを使用することで、任意の 2 つのビルド間で実際に変更された部分のみをアップロード・ダウンロードすることが保証されます。これにより、既存のバイナリ差分検出手法に対して 2 つの重要な点で改善されています。ほぼ最適であること、そして多数の非連続なビルド間でパッチを計算する際に組み合わせ爆発（combinatorial explosion）が発生しないことです。これにより、転送時間とストレージ要件が大幅に削減されます。比較テストでは、ビルドのエンドツーエンドの配信時間が 10 倍改善され、ストレージ要件がビルドごとに線形的に増加するのではなく、ビルドが進むごとに 10〜20% ずつ段階的に増加するだけになりました。
今後数か月の間に、Smart Builds が完全な一般提供に移行するのに伴い、既存の配信メカニズムを非推奨とする予定です。その準備が整った際には、その旨を明確にお知らせし、既存システムのビルドを Smart Builds へ簡単に移行できる移行ツールを提供します。
CLI を使用したスマートビルドのアップロード
ADT Hub からのスマートビルドのダウンロード
Android APK 配信
ADT のビルド配信に追加のプラットフォームサポートを求める要望を多数いただいていました。その一環として、ADT に Android サポートを追加しました。このリリースにより、Android APK は ADT で完全にサポートされるようになりました。これにより、ADT CLI やドラッグ＆ドロップを通じてビルドをアップロード・ダウンロードできます。また、Android デバイスを ADT Hub に接続し、接続されたデバイスにビルドをデプロイすることもできます。自動ダウンロード、デプロイ、プレイなど、通常の時間節約機能も Android で利用可能です。
Android デバイスのペアリング
Version ページからの Android ビルドのデプロイ
Overview ページからの Android ビルドのデプロイ
ビルドチャンネルのスケジュール自動更新
現在、自動更新は利用可能になった時点で即座にダウンロードされます。都合の良いタイミングでない場合など、これが望ましくない場合もあります。さらに、すべてのユーザーで自動更新が同時に発生すると、ネットワーク帯域の飽和を引き起こす可能性があります。ADT では、新しいビルドがダウンロードされる特定の時刻を設定することで、自動更新をスケジュールできるオプションが追加されました。すべてのクライアントが同時にダウンロードを試みることによるネットワーク混雑を軽減するために、スケジュールされた時刻に任意の時間オフセットを適用することもできます。
コマンドラインによるビルドステータスの制御
これまでも ADT Hub を通じてビルドのステータスを設定することは可能でしたが、コマンドラインからこれを行う機能を新たに追加しました。これにより、ビルドマシンから管理したい自動化ワークフローのサポートが強化されます。これを利用するには、以下に示す set-build-status という新しい CLI コマンドがあり、設定したいステータスを指定する --build-status 引数を取ります。
C/C++
.\BlackBoxCLI.exe build set-build-status --build-status <build_status> --namespace <namespace> --apikey <your_apikey> --game-project <the_game_project_path>
オプション
| Commands | Descriptions |
|---|---|
| --help,h | このヘルプメッセージを表示して終了する |
| --build-status TEXT (REQUIRED) | stable、notStable、stableWithNote、tbd、unverified のいずれかを選択する |
| --build-id TEXT (OPTIONAL) | ステータスを追加・変更したい buildID |
| ---version-id TEXT (OPTIONAL) | 使用する version ID を上書きする |
空のビルドチャンネルの作成
これまでは、ビルドチャンネルを作成する際に必ずビルドを指定する必要がありました。今回、空のビルドチャンネルを作成できる機能を追加しました。これにより、チャンネルの作成とビルドのアップロードのプロセスが分離され、より柔軟な自動化ワークフローが可能になります。この操作は CLI から、または ADT Hub から直接行うことができます。
C/C++
.\BlackBoxCLI.exe build-channel create-empty --name <build_channel_name> --namespace <namespace> --apikey <your_apikey>=
ADT CLI を使用した空のビルドチャンネルの作成
ADT Hub からの空のビルドチャンネルの作成
インストールフォルダの名前変更
現在、ADT はデフォルトのビルドインストールフォルダを強制し、これを変更することはできません。手動で変更しようとすると、ビルドがプレイできなくなります。このリリースでは、ビルドインストールフォルダを変更する方法を追加しました。ビルドのダウンロードが完了した後、省略記号（ellipses）メニューからこの新しいオプションを見つけることができます。
チャンネルページからのビルドインストールフォルダの変更
バージョンページからのビルドインストールフォルダの変更
Health の更新
一括削除
ビルドとクラッシュデータは時間の経過とともに急速に増加します。整理された状態を維持し、コストを管理するためには、これを効果的に管理できることが重要です。前回のリリースでは、バージョンと関連データを削除する基本的な機能を追加しました。このリリースでは、ADT により管理者が、ある期間内の複数のバージョンとそれに関連するビルド、メタデータ、バイナリファイル、シンボルファイルを簡単に削除できるようになりました。
カスタムコールスタックグルーピング
ADT がコールスタックの一致に使用するデフォルトのグルーピングは多くの状況で機能しますが、より精密な制御が必要な場合もよくあります。ADT web では、作成できるルールを使用してコールスタックの一致に対してより多くの制御を行えるようになりました。ルールは git ignore 形式のパターンマッチングを使用し、一致判定のためにコールスタックの行を除外できます。これはグローバル、モジュール、またはファイル単位で行うことができ、より細かい制御が可能です。さらに、マッチングアルゴリズムの一部として何行を対象とするかも制御できるようになりました。現在、これらのルールは新しいクラッシュにのみ適用され、既存のクラッシュには適用されません。
カスタムシンボルサーバー
ADT では、ADT の組み込みシンボルサーバーの代わりに、独自のシンボルサーバーを指定できるようになりました。この機能を有効にすると、ユーザーは PDB ファイルをアップロードする必要がなくなり、外部で管理できます。代わりに、ビルドを登録した後、CrashURL を指定するだけで済みます。この機能により、プロセスが簡素化され、シンボルとクラッシュの管理がより便利になります。現在、これは Windows ビルドでのみサポートされています。
オンボーディングツアーの改善
ADT ツアーは、web アプリケーションと hub アプリケーションの両方の主要機能を紹介するために設計された、包括的なインタラクティブガイドです。このツアーを通じて、ユーザーは ADT で利用可能な機能に簡単に慣れることができます。現在のツアーでは、ビルド配信の使い始め方、バージョンとビルドの管理、クラッシュレポートの設定方法を扱っています。今後も継続してこれを拡充し、ADT が提供する強力な機能セットに慣れやすくしていきます。
クラッシュおよびセッショングラフの新デザイン
ダッシュボードのセッションおよびクラッシュのグラフが読みにくいというフィードバックを受け取りました。読みやすくするために、これらを折れ線グラフから棒グラフに変更しました。
変更前：折れ線グラフによるセッションとクラッシュのグラフ
変更後：棒グラフによるセッションとクラッシュのグラフ
不具合の修正
全般
- Jira ボードをリセットした後でも、ユーザーが Jira チケットを作成できてしまう問題
- Power User アカウントの合計数に、Azure SSO を使用しているアカウントが含まれていなかった問題
Distribution
- アップロード中にトークンが期限切れとなり、アップロードが失敗する問題
- アクセス権のないユーザーがプライベートビルドチャンネルを検索できてしまう問題
Health
- ? や :: を使用してクラッシュを検索できない問題
- 類似したクラッシュによってアラートが繰り返しトリガーされる問題
- Version details ページで長いブランチ名を使用するとテキストが重なる問題
既知の問題
- 記録されたクラッシュ動画が、web 上で設定された動画の長さと一致しない場合がある