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 katalogujre_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 folderujre_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.