Unity Awaitable Analyzer

Unity Awaitable Analyzer v0.1.0

by Tool Accelerator Factory

Tools that accelerate development.

【この商品について】

「Unity Awaitable Analyzer」は、Unity 6の標準非同期処理

UnityEngine.Awaitableを使ったC#コードの中から、

不具合につながりやすい使い方を検出して警告する開発支援ツールです。

Unityプロジェクトに導入すると、コードのコンパイル時に問題のある箇所をチェックし、

Unity Consoleなどへ警告として表示します。

たとえば、

・同じAwaitableを2回awaitする

・await済みのAwaitableを再利用する

・バックグラウンドスレッドからメインスレッド専用の処理を呼ぶ

といった問題を検出します。

ゲーム本体へ機能を追加するアセットではなく、

開発中のC#コードをチェックするためのRoslyn Analyzerです。

【こんな問題を検出します】

UAD001：同じAwaitableローカル変数を繰り返しawaitする問題。

UAD002：Awaitableローカル変数をawaitした後にCancel()を呼び出す問題。

UAD003：バックグラウンド継続が確認された後に、

メインスレッド専用のAwaitable APIを呼び出す問題。

【内容物】

ZIPには以下のファイルが含まれます。

・Roslyn Analyzer DLL / netstandard2.0

・Unityメタデータ

・README

・LICENSE.txt

・CHANGELOG

・VERSION

本製品はUPMパッケージではなく、

Assetsへコピーして使用するDLL配布です。

【インストール】

ZIPを展開し、

Assets/UnityAwaitableAnalyzer をお使いのUnityプロジェクトの

Assetsディレクトリ直下へコピーしてください。

更新時は重複したアナライザーを避けるため、

先に既存の Assets/UnityAwaitableAnalyzer を削除してから

新しいフォルダーへ置き換えてください。

共有リポジトリには

/Assets/UnityAwaitableAnalyzer/

を登録しないでください。

チームで利用する場合は、利用者ごとに購入し、

各自のローカル環境へ個別に導入してください。

【動作確認環境】

検証済み：

Unity 6000.3.0f1

Windows

Roslyn Analyzer DLL / netstandard2.0

Unity 6000.3.0f1以外のUnityバージョン、

macOS、Linuxでの動作は未検証です。

【既知の制限】

解析は誤検出を避けることを優先した保守的なものとなっており、

ローカル変数のみを対象にします。

別名、フィールド、プロパティ、コレクションは追跡しません。

ループ、try文、switch文などの複雑な制御フローでは、

誤検出を避けるため解析精度が下がる場合があります。

UAD002は、現在Cancel()のみを対象にします。

UAD003は、現在以下の4 APIのみを対象にします。

・NextFrameAsync

・WaitForSecondsAsync

・FixedUpdateAsync

・EndOfFrameAsync

メソッド間のフロー解析およびコード修正機能は含まれていません。

本製品から警告が出ないことは、

コードの安全性を保証するものではありません。

【ライセンス概要】

1ライセンスは自然人1名です。

ライセンス保有者本人が利用する複数のコンピューターで利用でき、

個人制作、商用制作、受託開発、勤務先での開発を含む

複数のプロジェクトで利用できます。

本製品を含まないゲーム・アプリケーションなどの

ビルド済み成果物は配布できます。

DLLまたはパッケージを他者やチームメンバーと共有、再配布、再販売、

公開、譲渡、再許諾することはできません。

第三者がアクセスできるリポジトリ（非公開を含む）へ

Assets/UnityAwaitableAnalyzer を登録すること、

または本製品を含んだUnityソースプロジェクトを

第三者へ納品することもできません。

詳細な利用条件については、「v0.1.0 使用許諾契約書」を事前にご確認ください。

同じ使用許諾契約書は、980円の製品本体ZIPにも同梱されています。

【サポート】

技術サポート窓口：

[email protected]

以下について、best effortで対応します。

・インストール、インポートに関する問題

・アナライザーの読み込み失敗

・再現可能な診断不具合

・製品仕様に関する質問

お問い合わせの際は、可能な範囲で以下をお知らせください。

・製品バージョン

・Unityバージョン

・OS

・最小再現例

・関連ログ

秘密情報、認証情報、プロプライエタリな情報などは

送信しないようお願いいたします。

回答期限や問題解決の保証はありません。

プロジェクト全体のデバッグ、カスタムルール開発、

コンサルティング、Unity一般のサポートは対象外です。

本製品の購入には、将来の機能追加、

新しいUnityバージョンへの対応、

新しい製品バージョンの提供を受ける権利は含まれません。

販売者は、本製品のアップデート、修正、

または提供を継続する義務を負いません。

購入、支払い、ダウンロードに関するお問い合わせは、

BOOTHのメッセージをご利用ください。

キャンセルおよび返金については、

BOOTHの規約・運用に従います。