Przewodnik kompilacji i pakowania na urządzenia iOS

Tło

LCC Unity SDK jest publikowany w formie wstępnie skompilowanych bibliotek DLL. Ponieważ platforma iOS wymaga, aby wtyczki natywne były linkowane jako biblioteki statyczne (__Internal), a nie ładowane dynamicznie (dlopen), przed zbudowaniem aplikacji iOS musisz ukończyć dodatkowe kroki konfiguracyjne opisane w tym dokumencie. Istnieje fundamentalna różnica w mechanizmach ładowania wtyczek natywnych między iOS a innymi platformami; inne platformy (Windows, macOS, Android, Linux) nie wymagają żadnych dodatkowych operacji.

Ten SDK używa "libwebp" jako celu P/Invoke po skompilowaniu do DLL. Wbudowany skrypt SDK Editor/RewriteWebpDllImport.cs automatycznie przepisuje go na "__Internal" podczas kompilacji iOS, zapewniając, że IL2CPP generuje prawidłowe bezpośrednie wywołania symboli.

Uwaga:

Podczas kompilacji aplikacji na urządzenie iOS najpierw zmień nazwę Editor/RewriteWebpDllImport.txt w pakiecie SDK na Editor/RewriteWebpDllImport.cs, aby skrypt zadziałał. Alternatywnie bezpośrednio zmień rozszerzenie skryptu w pakiecie SDK i skopiuj go do katalogu Assets/Editor/ projektu.

Wymagania wstępne

Skrypt RewriteWebpDllImport.cs używa biblioteki przepisywania IL Mono.Cecil podczas kompilacji, więc musisz najpierw dodać ją jako zależność do projektu. Są dwa sposoby; wybierz jeden.

Metoda 1: Dodaj przez Menedżer pakietów (zalecana)

Otwórz pasek menu Unity Okno → Menedżer pakietów, kliknij przycisk + w lewym górnym rogu, wybierz Dodaj pakiet według nazwy..., wpisz nazwę com.unity.nuget.mono-cecil, wpisz wersję 1.11.5, kliknij Dodaj i poczekaj, aż Menedżer pakietów zakończy instalację, jak pokazano poniżej.

Dodaj com.unity.nuget.mono-cecil według nazwy w Menedżerze pakietów

Metoda 2: Ręcznie edytuj manifest.json

Bezpośrednio edytuj Packages/manifest.json projektu i dodaj wiersz pod dependencies:

{
  "dependencies": {
    "com.unity.nuget.mono-cecil": "1.11.5"
  }
}

Po zapisaniu przełącz się z powrotem do Unity; Edytor automatycznie rozwiąże i zainstaluje zależność.

Przepływ kompilacji

Po ukończeniu konfiguracji wymagań wstępnych postępuj zgodnie ze standardowym przepływem kompilacji iOS; RewriteWebpDllImport zainterweniuje automatycznie podczas kompilacji.

1. Zmień nazwę Editor/RewriteWebpDllImport.txt na Editor/RewriteWebpDllImport.cs (jeśli jeszcze nie zmieniono).
2. Na pasku menu Unity wybierz Plik → Ustawienia kompilacji, wybierz iOS z listy platform i kliknij Przełącz platformę.
3. Kliknij Kompiluj (lub Kompiluj i uruchom), wybierz katalog wyjściowy i wygeneruj projekt Xcode.
4. Podczas kompilacji skrypt automatycznie przepisuje wszystkie wpisy DllImport w SDK kierujące na "libwebp" na "__Internal". Po pomyślnej kompilacji Konsola wyświetla dziennik podobny do:

[RewriteWebpDllImport] Rewrote 77 P/Invoke entries from "libwebp" to "__Internal".

5. Otwórz wygenerowany projekt w Xcode i w sekcji Fazy kompilacji → Połącz pliki binarne z bibliotekami celu potwierdź, że libwebp.a, libwebpdemux.a i libsharpyuv.a są linkowane.
6. Podłącz urządzenie iOS, podpisz i uruchom w Xcode.

Uwaga:

Jeśli dziennik [RewriteWebpDllImport] nie pojawia się w Konsoli, zwykle oznacza to, że skrypt nie zadziałał — potwierdź, że rozszerzenie pliku zostało zmienione z .txt na .cs i że zależność Mono.Cecil jest poprawnie zainstalowana.

Rozwiązywanie problemów

Uwagi

• Zaleca się używanie Unity 2022.3 LTS lub nowszego (w tym Unity 6); zgodności z Mono.Cecil i IL2CPP nie można zagwarantować na zbyt starych wersjach.
• Jeśli musisz uruchamiać na Symulatorze iOS, potwierdź, że linkowana biblioteka statyczna zawiera wycinek architektury arm64-simulator, w przeciwnym razie symulator nie może linkować.
• Powyższa konfiguracja dotyczy tylko platformy iOS. Przepływy kompilacji Windows, macOS, Android i Linux nie są w ogóle naruszone i nie ma potrzeby zmiany nazwy skryptu ani dodawania zależności Mono.Cecil.