Dodawanie projektu JreEmulation do projektu Xcode

Biblioteka emulacji JRE J2ObjC można utworzyć za pomocą Xcode i można ją dołączyć jako podprojekt w projektach Xcode. Dzięki temu możesz kontrolować ustawienia używane do tworzenia tej biblioteki, aby można było jak najlepiej wykorzystać ją w projektach.

Pobierz kod źródłowy

Wykonaj jedną z tych czynności: – Pobierz bieżący pakiet źródłowy i skompresuj go do katalogu lokalnego lub – skopiuj drzewo kodu źródłowego za pomocą usługi git. Zaletą takiego rozwiązania jest to, że łatwiej jest być na bieżąco z najnowszymi zmianami w projekcie J2ObjC, ale wymaga to pewnej wiedzy z zakresu systemów kontroli wersji.

Kod źródłowy możesz umieścić w dowolnym miejscu w systemie lokalnym. W tym dokumencie użyjemy adresu /usr/local/src/j2objc, ale możesz zmienić tę ścieżkę według uznania.

Zainstaluj narzędzia do budowania

Do kompilacji J2ObjC muszą być zainstalowane narzędzia wiersza poleceń Xcode i Apache Maven. Oto kilka porad:

Są to wyszukiwania w Google, a nie strony statyczne, ponieważ w przypadku nowych wersji systemu macOS X i Xcode instalacja często może się zmieniać.

Zbuduj projekt

Wykonaj instrukcje Building J2ObjC. Kompilacje z użyciem wiersza poleceń są opcjonalne, ale łatwiejsze do debugowania niż przy wywoływaniu wewnątrz Xcode.

Podczas debugowania środowiska JRE zalecamy dodanie tych wierszy u góry pliku jre_emul/environment.mk przed uruchomieniem czystej kompilacji:

DEBUGGING_SYMBOLS=YES
OPTIMIZATION_LEVEL=0

Projekt JreEmulation Xcode

W Xcode otwórz /usr/local/src/j2objc/jre_emul/JreEmulation.xcodeproj. Jego foldery to między innymi:

  • Klasy: zestaw podstawowych klas emulacji środowiska JRE, które nie są tworzone przez tłumaczenie plików źródłowych Java.
  • jre_emul_tests: zestaw testów jednostkowych tworzonych i uruchamianych w Xcode. Nie obejmuje to przetłumaczonych testów JUnit, które są tworzone i uruchamiane z poziomu wiersza poleceń przy użyciu make test w katalogu jre_emul.
  • Transpilowane klasy: to pliki utworzone przez przetłumaczenie plików źródłowych biblioteki JRE w Javie. Uwagi:
  • Xcode oznacza brakujące pliki na czerwono. Ponieważ te pliki są tworzone podczas kompilacji, początkowo wszystkie będą czerwone, dopóki projekt nie zostanie utworzony.
  • Regularnie dodajemy nowe klasy do biblioteki emulacji JRE, więc ta lista może być nieaktualna. Jeśli tak, kliknij go prawym przyciskiem myszy, wybierz „Add Files to JreEmulation.xcodeproj” (Dodaj pliki do JreEmulation.xcodeproj), a następnie dodaj nowe pliki .m i .h z folderu jre_emul/build_result/Classes oraz jego podkatalogów.

Aby skompilować projekt JreEmulation, wybierz środowisko docelowe jre_emul i kliknij przycisk Uruchom w Xcode. Aby skompilować i uruchomić testy jednostkowe, kliknij strzałkę w dół obok przycisku Wykonaj i wybierz Przetestuj.

Dodaj projekt JreEmulation do projektu

  • W panelu Project Naviagator po lewej stronie kliknij swój projekt prawym przyciskiem myszy i wybierz „Dodaj pliki do: Nazwa projektu”.
  • Znajdź plik jre_emul/JreEmulation.xcodeproj i kliknij przycisk Dodaj.
  • Kliknij projekt i wybierz jego główne miejsce docelowe, a następnie wybierz kartę Fazy kompilacji środowiska docelowego.
  • Otwórz sekcję zależności docelowe, kliknij przycisk + i wybierz wartość docelową jre_emul.
  • Otwórz sekcję Połącz plik binarny z bibliotekami, kliknij przycisk + i wybierz libjre_emul.a.
  • Kliknij kartę Ustawienia kompilacji środowiska docelowego, odszukaj Ścieżki wyszukiwania w nagłówku i dodaj ścieżkę do katalogu /usr/local/src/j2objc/dist/include (podając rzeczywistą lokalizację).

Teraz, po utworzeniu projektu, tworzony jest zgodnie z potrzebami projekt JreEmulation.