EasyAR Sense Unity Plugin 移行ガイド

この文書では、古いバージョンの EasyAR Sense Unity Plugin から新しいバージョンへの移行方法について説明します。

互換性に関する説明

バージョン 4000 以降、EasyAR Sense Unity Plugin は Unity が要求するパッケージバージョン管理（セマンティックバージョニングを使用）に従い、互換性はバージョン番号で判断できます。

4.7 は段階的な更新バージョンであり、いずれの 2 つの 4.7 バージョンも互換性がありません。

4.7 より前のバージョンでは、3 番目のバージョン番号のみが下位互換性を示し、最初の 2 つのバージョン番号の変更はいずれも非互換性を示します。例えば、4.6.2 は 4.6.1 と互換性がありますが、4.6.0 と 4.5.0 は互換性がありません。

警告

tgz ファイルの変更、または解凍後にプラグイン全体を完全に更新しないと、互換性が失われます。

一般的な移行ガイド

新しいバージョンへの移行には、まず Package Manager window を使用して古いバージョンのプラグインパッケージを削除し、新しいパッケージを追加する必要があります。

以下の手順で操作することをお勧めします：

使用中の Unity を閉じます。
Unity がビルド時に生成するプラットフォームビルドディレクトリを削除します。
Unity プロジェクトを再度開き、古いバージョンの EasyAR Sense Unity Plugin をプロジェクトから削除します。
新しいバージョンの EasyAR Sense Unity Plugin をインポートします。

注記

プラグインが提供するサンプルファイルは、バージョン間の互換性を保証するものではありません。プラグインをアップグレードした後、プロジェクトにインポートされたサンプルが正常に動作しない可能性があるため、古いバージョンのサンプルを削除してから操作することをお勧めします。

EasyAR にはネイティブライブラリファイルが含まれており、削除または置換前にライブラリ関数が実行された場合（ビルド時にも呼び出されます）、これらのライブラリファイルはシステムによってロックされ、削除または置換できなくなります。

重要

古いバージョンを削除する前に、エディターでシーンを実行したり、いかなるプラットフォームのアプリケーションもビルドしていないことを確認する必要があります。通常、パッケージを削除または置換する前に Unity を閉じ、再度開いた直後に置換することをお勧めします。

新しいバージョンのプラグインを使用して再ビルドする前に、Unity のビルドによって生成されたプラットフォームビルドディレクトリを削除する必要があります。これには、Android ビルドで生成された Gradle プロジェクトディレクトリや、iOS ビルドで生成された Xcode ディレクトリも含まれます。

ヒント

通常、これらのディレクトリは Unity プロジェクトの Library フォルダ内にある可能性があります（例: Library/Bee/Android/Prj/IL2CPP/Gradle）。ただし、Unity のバージョンによって異なる場合があります。

ビルドしたことがあるのに該当するプラットフォームのディレクトリが見つからない場合は、Library フォルダ全体を削除することをお勧めします。

移行後に SchemaHashNotMatched 例外が発生した場合、通常は次の 2 つの可能性があります

前述の操作が正しく行われなかったため、アップグレードが失敗したか不完全であるか、または Unity が生成したビルドディレクトリが正しく更新されていない（注意：手動で削除していない場合、高い確率でエラーが発生します）。推奨手順に従って操作するか、Library キャッシュのないプロジェクトで再コンパイルすることをお勧めします。
EasyAR の tgz ファイルを手動で変更した、または解凍後にプラグイン全体を完全に更新しなかった。この場合、EasyAR は可用性を保証できないため、正しいパッケージを再ダウンロードしてインポートする必要があります。

重要

EasyAR Sense のライブラリファイルおよびそれらのビルド後の配置場所は変更される可能性があるため、Unity が生成した Gradle または Xcode プロジェクトを保持している場合は、EasyAR.aar、libEasyAR.so、easyar.framework など、EasyAR に関連するすべてのファイルを事前に削除する必要があります。

バージョン 4001 への移行

ヒント

Mega を使用する場合にのみ非互換の変更があります。その他の機能の使用には影響しません。

バージョン 4000 から 4001 への移行時には、上記の一般的な移行ガイドに加えて、以下の内容に注意する必要があります。

インターフェースの変更

機能モジュール	v4000 API	v4001 API	使用説明
Mega	MegaTrackerFrameFilter.ResultPoseType.EnableLocalization	MegaTrackerFrameFilter.EnableLocalization	Mega トラッキングプロセスの制御
Mega	MegaTrackerFrameFilter.ResultPoseType.EnableStabilization	-	機能削除済み

過去のバージョンからの移行

4000 より前のバージョンから移行する場合は、以下の内容を参照してください：

Table of Contents