Addressableアドレス自動付与ツール「Smart Addresser」の概要と使い方

Addressableアドレス自動付与ツール「Smart Addresser」の概要と使い方 SGEコア技術本部 2023.04.13 矢野春樹

SmartAddresser ついさっき100Starsに！

Smart Addresserの概要 Chapter : 01

アドレス付与、どうしてますか？

手動 Drag & Drop

自動化 ※処理は適当です

書いた人以外にわかりづらくなりがち車輪の再発明しがち

Smart Addresserの基本的な使い方 Chapter : 02

Addressable Groupを作る普通にAddressableのウィンドウから作る SmartAddresserは、Addressable Groupを作ったり、その設定を変更したりはしません ※ このあたりやりすぎると色々とカオスになるため（どこまでやるのか難しくなる）

Layout Rule Dataを作る Smart Addresserのユーザデータを保存するScriptable Object Assets > Create >
Smart Addresser > Layout Rule Data から作る

制御するAddressable Groupを決める前ページのLayout Rule Dataをダブルクリックして下図のウィンドウを開く Smart Addresserで制御するAddressable Groupにチェックチェック

アドレス付与対象のアセットを設定する Addressable Groupを選択し、右側のAsset Groupsタブから「+」ボタンを押下しこのAddresable Groupに含めるアセット群を決めていく「全アセットから対象のアセットをフィルタリングしていく」という考え方図は「Rockフォルダ配下の拡張子がprefabのもの」全てをアドレス付与の対象としてる図 Rockフォルダ内拡張子がprefab

カスタムアセットフィルタいろんなフィルタがあります独自のアセットフィルタも作れますマスタデータに定義されているIDを含むアセットだけフィルタリングとか

アドレスプロバイダーを設定する右側のAddress Providerタブからアドレスの付与方法を設定アセットパスをアドレスにしたり、アセット名をアドレスにしたり正規表現を使ってReplaceした結果をアドレスにすることも可能 Assets/Prefabs/Characters/0001.prefab → pfb_ch_0001 みたいな Address
Provider タブアセットパス/アセット名.. 正規表現設定

カスタムアドレスプロバイダー独自のアドレスプロバイダーも作れますマスタデータに定義されているアドレスを付与したいとか ※これ以降省略しますが、基本的にこういう拡張性あるべきところに全て入れてます

適用する右上のメニュー > Apply to Addressables もちろん適用するためのCLIもあります

自動適用 Project Settings > Smart Addresser > Primary Data に設定した
Layout Rule Dataはアセット追加・移動時に自動的に適用される（差分のみ）このルール自体に変更を加えた際には全適用する

ラベルも大体同じ Label Rulesタブから設定できる Asset Group と Label Providerを設定して付与できるパスにPlayer/Enemyを含む全Prefabにcharacterというラベルを付与するとか Label
Rulesタブ

Layout Viewerでチェック現在の設定に基づいて実際にプロジェクト内のアセットがどうレイアウトされるか見れるエラーや警告があったらその詳細も見れますバリデーションするためのCLIもあります

バージョン管理機能 Chapter : 03

バージョン管理機能とはアセットごとにバージョン（semver）を振れる指定したバージョンアセットのみをAddressableに適用できる e.g. バージョン1.0.0以上2.0.0以下のアセットのみをAddressableに適用 ※ オプショナルな機能なので使わなくてもOK 1.0.0 1.1.0 1.2.0
2.0.0 2.1.0 2.2.0 3.0.0 3.1.0 3.2.0 バージョン1.0.0以上2.0.0以下のアセットだけを適用

設定方法は大体ラベルと同じ Version Rulesタブで設定

適用前にバージョン範囲を指定 Settingsタブでバージョンの範囲を指定できる指定方法はUnityのVersionDeﬁnesに準拠するように作っています例えば1.0.0以上1.2.0未満だったら [1.0.0,1.2.0) みたいな感じ独自のバージョン範囲解釈クラス（VersionExpressionParser）を使うことも可能バージョンの範囲を指定バージョン振ってないアセットを除外するならチェック

依存関係に注意バージョン管理機能はあくまで対象のアセットをAddressableに登録しないだけです当然ながら、リリース可能バージョンのアセットから、リリース不可能バージョンのアセットへの依存がある場合には、Asset Bundleにリリース不可能バージョンのアセットが暗黙的に含まれます実際のユースケースを考えるとそもそもアセットの作り方をミスってない限りそんなことは起こらないはずですが、一応ご注意を（そういうミスの検知にはAsset Regulation
Managerがおすすめです） 1.0.0 3.0.0 リリース可能リリース不可能参照してたら含まれてしまう

ぜひ使ってみてください github.com/CyberAgentGameEntertainment/SmartAddresser

Addressableアドレス自動付与ツール「Smart Addresser」の概要と使い方

Addressableアドレス自動付与ツール「Smart Addresser」の概要と使い方

Haruki Yano

More Decks by Haruki Yano

Other Decks in Programming

Featured

Transcript