Debugowanie problemów „Nie znaleziono współdzielonego kodu”

Prawie każdy napotyka ją raz: iOS się kompiluje, ale Swift nie może znaleźć wspólnego API. Spokojnie zdiagnozujmy problem nie znaleziono wspólnego kodu. 🛠️

Najpierw uruchom bezpośrednio zadanie Gradle budujące framework. Jeśli zakończy się ono niepowodzeniem poza Xcode, framework nigdy nie powstał i Swift nie miał czego połączyć.

Swift musi importować dokładną wartość baseName ustawioną w build.gradle.kts. Niezgodna nazwa to najczęstsza przyczyna błędu „no such module”.

Gradle’owa faza kompilacji musi zostać wykonana przed Compile Sources. Jeśli znajduje się zbyt nisko na liście, Swift kompiluje się, zanim framework powstanie.

Xcode musi wiedzieć, gdzie znajduje się framework. Proszę sprawdzić, czy Framework Search Paths wskazuje folder wynikowy Gradle dla danego celu.

Korzystasz z CocoaPods, ale otworzyłeś .xcodeproj? Brakuje podów. Zamknij ten plik i otwórz zamiast niego .xcworkspace.

Framework arm64 nie połączy się z symulatorem x86. Upewnij się, że framework został zbudowany dla tej samej architektury co cel uruchomienia.

Rozwiń nieudaną fazę w dzienniku kompilacji i znajdź pierwszy błąd. Późniejszy komunikat konsolidatora często jest tylko skutkiem wcześniejszego błędu.

Stare artefakty mogą wprowadzać konsolidator w błąd. Czysta kompilacja Gradle w połączeniu z czyszczeniem w Xcode często usuwa uporczywy błąd braku pliku.

Tylko deklaracje Kotlina oznaczone jako public są dostępne w Swifcie. Jeśli klasa jest wewnętrzna, Swift jej nie zobaczy, niezależnie od tego, jak framework zostanie podłączony.

Te błędy wyglądają groźnie, ale prawie zawsze dotyczą konfiguracji: nazwy, ścieżki, kolejności lub architektury. Sprawdź te cztery elementy, a problem powinien ustąpić. ✨

Nauczyłeś się diagnozować błędy braku elementu, sprawdzając, czy framework został zbudowany, nazwę importu, kolejność faz kompilacji, ścieżki wyszukiwania i architekturę. Większość poprawek dotyczy konfiguracji, a nie kodu. 🎉