Persyaratan
- Sistem Apple Mac OS X
- Xcode versi terbaru
- JDK 11 diinstal
- Apache Maven
- (Disarankan tetapi tidak diwajibkan) Sumber Buffering Protokol Google
Penyiapan Mac
- Instal alat command line Xcode dengan menjalankan:
sudo xcode-select --install
- Tambahkan ke
.bash_profile
:
export JAVA_HOME=`/usr/libexec/java_home -v 11`
Membuat Fork untuk project J2ObjC
Untuk melakukan fork project J2ObjC, buka halaman utamanya dan klik tombol Fork:
Pilih nama akun GitHub Anda, dan fork akan dibuat dalam beberapa detik.
Selanjutnya, clone salinan fork ke sistem lokal Anda untuk pengembangan. Pertama, klik [tombol Clone atau download], lalu klik tombol Copy to Clipboard:
Kemudian, clone ke direktori lokal:
git clone (Command-V) # Paste the copied URL
Menginstal protobuf
Anda harus menginstal protobuf C++ sebelum dapat mem-build J2ObjC.
Untuk menginstal paket biner protobuf, gunakan Homebrew:
brew install protobuf
Anda perlu menetapkan PROTOBUF_ROOT_DIR
ke root tempat protobuf diinstal.
Biasanya, itu adalah /usr/local
default Homebrew. Tambahkan kode berikut ke .bash_profile
Anda:
export PROTOBUF_ROOT_DIR=/usr/local # or your custom Homebrew dir
Untuk memverifikasi, jalankan $PROTOBUF_ROOT_DIR/bin/protoc --version
.
Gedung J2ObjC
Untuk mem-build dari command line di jendela Terminal, jalankan:
# Build just the translator and libraries
make dist
# Build the full distribution (including frameworks)
make frameworks
# Build the protocol buffer compiler and runtime for J2ObjC
make protobuf_dist
# Build everything that is included in the project's distribution bundles
make all_dist
Penyiapan Opsional untuk Buffering Protokol
Compiler dan runtime Buffering Protokol J2ObjC mengharuskan penginstalan Buffering Protokol (setidaknya 3.21.3):
- Download kode sumber dari rilis Protocol Buffers 3.21.7.
- Ikuti petunjuk penginstalan C++ dari README. Perhatikan opsi
--prefix
untuk menentukan lokasi penginstalan Anda. - Tentukan variabel lingkungan
PROTOBUF_ROOT_DIR
untuk diarahkan ke lokasi penginstalan Buffering Protokol.
Memposting fitur bahasa Java 8.
Lihat pengumuman. Selain langkah-langkah di bagian sebelumnya, modul JRE harus dibuat dengan JDK 11:
JAVA_HOME=`/usr/libexec/java_home -v 11` \
make -C jre_emul/ -f java.mk emul_module_dist
Menguji J2ObjC
Untuk menguji dari command line di jendela Terminal, jalankan:
# Run translator and library unit tests
make test
# Run all unit tests, including for protocol buffers
make test_all
Membersihkan/Mereset Build
# Remove all files generated by the build
make clean
Build Paralel
Build J2ObjC mendukung build paralel, yang ditentukan menggunakan flag -j<n>
, dengan n adalah
jumlah maksimum tugas serentak. Jumlah maksimum bergantung pada seberapa cepat/kuatnya sistem Anda; sebaiknya
mulai dengan -j4
. Tingkatkan jumlah untuk mempersingkat waktu build jika sistem Anda dapat menanganinya, dan kurangi jika pembuatan gagal dengan error sistem.
Arsitektur Prosesor Bangunan
Mulai rilis j2objc 2.3, arsitektur iOS 32-bit ("iphone" dan "simulator") tidak disertakan dalam distribusi publik. Anda dapat membuat j2objc menggunakan kode ini dengan menentukan variabel lingkungan J2OBJC_ARCHS terlebih dahulu:
$ export J2OBJC_ARCHS="iphone simulator macosx iphone64 watchv7k watch64 watchsimulator simulator64"
$ make -j8 all_dist
Fungsi ini juga dapat digunakan untuk mempercepat build, dengan hanya menetapkan arsitektur yang dibutuhkan aplikasi Anda.
Untuk hanya mem-build iOS 64-bit ("iphone64") dan simulator terkait ("simulator64"), misalnya, tentukan J2OBJC_ARCHS="iphone64 simulator64"
sebelum menjalankan make.