Table of Contents

EasyAR Sense Unity Plugin Migrationsanleitung

In diesem Artikel wird erläutert, wie Sie von einer alten Version des EasyAR Sense Unity Plugins zu einer neuen Version migrieren.

Kompatibilitätshinweise

Ab Version 4000 folgt das EasyAR Sense Unity Plugin der von Unity geforderten Paketversionierung (Verwendung von Semantic Versioning), und die Kompatibilität kann anhand der Versionsnummer ermittelt werden.

4.7 ist eine schrittweise Update-Version; zwei beliebige 4.7-Versionen sind nicht kompatibel miteinander.

Bei Versionen vor 4.7 gibt nur die dritte Versionsnummer die Abwärtskompatibilität an; Änderungen an den ersten beiden Versionsnummern bedeuten Inkompatibilität. Zum Beispiel ist 4.6.2 kompatibel mit 4.6.1, aber 4.6.0 ist nicht kompatibel mit 4.5.0.

Warnung

Das Ändern der tgz-Datei oder das unvollständige Aktualisieren des gesamten Plugins nach dem Entpacken führt zu Inkompatibilität.

Allgemeine Migrationsanleitung

Um zu einer neuen Version zu migrieren, müssen Sie zunächst das alte Plugin-Paket über das Package Manager-Fenster entfernen und das neue Paket hinzufügen.

Es wird empfohlen, wie folgt vorzugehen:

  1. Schließen Sie die verwendete Unity-Instanz.
  2. Löschen Sie die plattformspezifischen Kompilierungsverzeichnisse, die beim Packen der Anwendung durch Unity erstellt wurden.
  3. Öffnen Sie das Unity-Projekt erneut und entfernen Sie die alte Version des EasyAR Sense Unity Plugins aus dem Projekt.
  4. Importieren Sie die neue Version des EasyAR Sense Unity Plugins.

Anmerkung

Die vom Plugin bereitgestellten Beispieldateien sind nicht garantiert zwischen Versionen kompatibel. Nach einem Upgrade des Plugins funktionieren die in das Projekt importierten Beispiele möglicherweise nicht mehr ordnungsgemäß. Es wird empfohlen, die alten Beispiele zu löschen, bevor Sie fortfahren.

EasyAR enthält native Bibliotheksdateien. Wenn Bibliotheksfunktionen ausgeführt wurden (was auch beim Packen geschieht), bevor sie gelöscht oder ersetzt wurden, werden diese Bibliotheksdateien vom System gesperrt und können nicht gelöscht oder ersetzt werden.

Wichtig

Bevor Sie die alte Version löschen, stellen Sie sicher, dass keine Szene im Editor ausgeführt wird und keine Anwendung für eine Plattform gepackt wird. Es wird im Allgemeinen empfohlen, Unity zu schließen, bevor Sie ein Paket löschen oder ersetzen, und es sofort nach dem erneuten Öffnen zu ersetzen.

Bevor Sie mit dem neuen Plugin neu packen, müssen Sie die von Unity erstellten plattformspezifischen Kompilierungsverzeichnisse löschen, einschließlich des Gradle-Projektverzeichnisses für Android und des Xcode-Verzeichnisses für iOS.

Tipp

Normalerweise befinden sich diese Verzeichnisse möglicherweise im Library-Ordner des Unity-Projekts (z. B. Library/Bee/Android/Prj/IL2CPP/Gradle), dies kann jedoch bei verschiedenen Unity-Versionen unterschiedlich sein.

Wenn Sie bereits gepackt haben, das Verzeichnis für die entsprechende Plattform aber nicht finden können, wird empfohlen, den gesamten Library-Ordner zu löschen.

Wenn nach der Migration eine SchemaHashNotMatched-Ausnahme auftritt, gibt es normalerweise zwei Möglichkeiten

  1. Die oben genannten Schritte wurden nicht korrekt durchgeführt, was zu einem fehlgeschlagenen oder unvollständigen Upgrade führte, oder die von Unity generierten Kompilierungsverzeichnisse wurden nicht korrekt aktualisiert (Hinweis: Wenn nicht manuell gelöscht, tritt sehr wahrscheinlich ein Fehler auf). Es wird empfohlen, die vorgeschlagenen Schritte auszuführen oder das Projekt neu zu kompilieren, das keinen Library-Cache hat.
  2. Die tgz-Datei von EasyAR wurde manuell geändert oder das gesamte Plugin wurde nach dem Entpacken nicht vollständig aktualisiert. In diesem Fall kann EasyAR die Funktionsfähigkeit nicht garantieren; Sie müssen das korrekte Paket erneut herunterladen und importieren.
Wichtig

Da sich die Speicherorte der Bibliotheksdateien von EasyAR Sense und der gepackten Bibliotheksdateien ändern können, müssen Sie, wenn Sie die von Unity generierten Gradle- oder Xcode-Projekte beibehalten, vorab alle mit EasyAR zusammenhängenden Dateien löschen, z. B. EasyAR.aar, libEasyAR.so, easyar.framework usw.

Migration zu Version 4002

Bei der Migration von Version 4001 zu 4002 müssen Sie zusätzlich zu oben genannten allgemeinen Migrationsanleitung auf Folgendes achten.

API-Änderungen

Funktionsmodul v4001 API v4002 API Verwendungsanweisung
Hilfsfunktionen Image.Image(Buffer, PixelFormat, int, int) Image.create

Migration zu Version 4001

Tipp

Es gibt nur inkompatible Änderungen bei der Verwendung von Mega; die Verwendung anderer Funktionen ist nicht betroffen.

Bei der Migration von Version 4000 zu 4001 müssen Sie zusätzlich zu oben genannten allgemeinen Migrationsanleitung auf Folgendes achten.

API-Änderungen

Funktionsmodul v4000 API v4001 API Verwendungsanweisung
Mega MegaTrackerFrameFilter.ResultPoseType.EnableLocalization MegaTrackerFrameFilter.EnableLocalization Steuerung des Mega-Tracking-Prozesses
Mega MegaTrackerFrameFilter.ResultPoseType.EnableStabilization - Funktion entfernt

Migration früherer Versionen

Bei der Migration von Versionen vor 4000 müssen Sie auf Folgendes verweisen:

Verwandte Themen