Migrationsleitfaden für easyar sense unity plugin
Dieser Artikel beschreibt, wie man von einer älteren Version des easyar sense unity plugins auf eine neue Version migriert.
Kompatibilitätshinweise
Ab Version 4000 folgt das easyar sense unity plugin der von unity geforderten paketversionsverwaltung (mit semantischer versionierung). Die kompatibilität kann anhand der versionsnummer beurteilt werden.
4.7 ist eine inkrementelle aktualisierungsversion. Keine zwei 4.7-versionen sind miteinander kompatibel.
Bei versionen vor 4.7 zeigt nur die dritte versionsnummer abwärtskompatibilität an. Änderungen an den ersten beiden versionsnummern bedeuten inkompatibilität. Beispielsweise ist 4.6.2 mit 4.6.1 kompatibel, aber 4.6.0 ist nicht mit 4.5.0 kompatibel.
Warnung
Änderungen an tgz-dateien oder unvollständige aktualisierungen nach dem entpacken führen zu inkompatibilität.
Allgemeiner migrationsleitfaden
Die migration auf eine neue version erfordert das entfernen des alten plugin-pakets über das package manager window und das hinzufügen des neuen pakets.
Empfohlene schritte:
- Schließen sie die laufende unity-instanz.
- Löschen sie die plattformkompilierungsverzeichnisse, die von unity beim erstellen von builds generiert wurden.
- Öffnen sie das unity-projekt erneut und entfernen sie die alte version des easyar sense unity plugins.
- Importieren sie die neue version des easyar sense unity plugins.
Anmerkung
Die mit dem plugin gelieferten beispieldateien sind nicht versionskompatibel garantiert. Nach einem plugin-update funktionieren importierte beispiele möglicherweise nicht mehr. Es wird empfohlen, alte beispiele vor der migration zu löschen.
Easyar enthält native bibliotheksdateien. Wenn bibliotheksfunktionen aufgerufen wurden (auch beim build-vorgang), werden diese dateien vom system gesperrt und können nicht gelöscht oder ersetzt werden.
Wichtig
Vor dem löschen der alten version müssen sie sicherstellen, dass keine szene im editor läuft und keine builds für plattformen erstellt werden. Es wird generell empfohlen, unity vor dem ersetzen oder löschen von paketen zu schließen und sofort nach dem neustart zu ersetzen.
Vor dem neu erstellen von builds mit der neuen plugin-version müssen sie die von unity generierten plattformkompilierungsverzeichnisse löschen. Dazu gehören das für android-builds generierte gradle-projektverzeichnis und das für ios-builds generierte xcode-verzeichnis.
Tipp
Diese verzeichnisse befinden sich normalerweise im library-ordner des unity-projekts (z.b. library/bee/android/prj/il2cpp/gradle), aber dies kann je nach unity-version variieren.
Falls sie builds erstellt haben, aber die entsprechenden verzeichnisse nicht finden, empfehlen wir, den gesamten library-ordner zu löschen.
Wenn nach der migration eine schemahasnotmatched-ausnahme auftritt, gibt es typischerweise zwei mögliche ursachen:
- Die vorherigen schritte wurden nicht korrekt durchgeführt, was zu einem fehlgeschlagenen oder unvollständigen update führte, oder die von unity generierten kompilierungsverzeichnisse wurden nicht korrekt aktualisiert (hinweis: wenn sie nicht manuell gelöscht wurden, tritt wahrscheinlich ein fehler auf). Führen sie die empfohlenen schritte aus oder verwenden sie ein projekt ohne
library-cache für die neukompilierung. - Sie haben die easyar-tgz-datei manuell geändert oder das plugin nach dem entpacken nicht vollständig aktualisiert. In diesem fall kann easyar keine funktionsfähigkeit garantieren. Laden sie das korrekte paket neu herunter und importieren sie es.
Wichtig
Da die positionen der easyar sense-bibliotheksdateien und der dateien nach dem build-vorgang sich ändern können, müssen sie, wenn sie die von unity generierten gradle- oder xcode-projekte beibehalten, alle dateien im zusammenhang mit easyar vorab löschen, z.b. easyar.aar, libeasyar.so, easyar.framework usw.
Migration auf version 4001
Tipp
Es gibt nur inkompatible änderungen bei der verwendung von mega, die nutzung anderer funktionen bleibt unberührt.
Bei der migration von version 4000 auf 4001 müssen sie zusätzlich zum allgemeinen migrationsleitfaden folgende punkte beachten.
Schnittstellenänderungen
| Funktionsmodul | v4000-api | v4001-api | Verwendungshinweise |
|---|---|---|---|
| Mega | megatrackerframefilter.resultposetype.enablelocalization | <xref:u:easyar.megatrackerframefilter.enablelocalization?displayproperty=namewithtype> | steuerung des mega-trackingprozesses |
| Mega | megatrackerframefilter.resultposetype.enablestabilization | - | Funktion entfernt |
Migration älterer versionen
Bei der migration von versionen vor 4000 müssen sie folgende inhalte beachten: