Aturan Objective-C

Aturan

• j2objc_library
• objc_import
• objc_library
• available_xcodes
• xcode_config
• xcode_version

j2objc_library

j2objc_library(name, deps, compatible_with, deprecation, distribs, entry_classes, features, jre_deps, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)

Aturan ini menggunakan J2ObjC untuk menerjemahkan file sumber Java ke Objective-C, yang kemudian dapat digunakan sebagai dependensi aturan objc_library dan objc_binary. Informasi mendetail tentang J2ObjC sendiri dapat ditemukan di situs J2ObjC

Flag transpilasi J2ObjC kustom dapat ditentukan menggunakan flag build --j2objc_translation_flags pada command line.

Perlu diketahui bahwa file yang diterjemahkan dan disertakan dalam target j2objc_library akan dikompilasi menggunakan konfigurasi kompilasi default, konfigurasi yang sama seperti untuk sumber aturan objc_library tanpa opsi kompilasi yang ditentukan dalam atribut.

Selain itu, kode yang dihasilkan akan dihapus duplikatnya di tingkat target, bukan di tingkat sumber. Jika memiliki dua target Java berbeda yang menyertakan file sumber Java yang sama, Anda mungkin melihat error simbol duplikat pada waktu penautan. Cara yang tepat untuk menyelesaikan masalah ini adalah dengan memindahkan file sumber Java yang dibagikan ke target umum terpisah yang dapat diandalkan.

Argumen

Atribut
name	Name; required Nama unik untuk target ini.
deps	List of labels; optional Daftar target j2objc_library, java_library, java_import dan java_proto_library yang berisi file Java yang akan ditranspilasi ke Objective-C. Semua target java_library dan java_import yang dapat dicapai secara transitif melalui exports, deps, dan runtime_deps akan diterjemahkan dan dikompilasi. Saat ini, tidak ada dukungan untuk file yang dihasilkan oleh pemrosesan anotasi Java atau target java_import tanpa srcjar yang ditentukan. Terjemahan J2ObjC berfungsi secara berbeda bergantung pada jenis file sumber Java sumber yang disertakan dalam penutupan transitif. Untuk setiap file sumber .java yang disertakan dalam srcs dari java_library, file sumber .h dan .m yang sesuai akan dihasilkan. Untuk setiap jar sumber yang disertakan dalam srcs dari java_library atau srcjar dari java_import, file sumber .h dan .m yang sesuai akan dibuat beserta semua kode untuk jar tersebut. Pengguna dapat mengimpor file header yang dihasilkan J2ObjC dalam kode mereka. Jalur impor untuk file ini adalah jalur relatif root dari artefak Java asli. Misalnya, //some/package/foo.java memiliki jalur impor some/package/foo.h dan //some/package/bar.srcjar memiliki some/package/bar.h Jika aturan proto_library berada dalam penutupan transitif aturan ini, proto J2ObjC juga akan dibuat, dikompilasi, dan ditautkan pada level biner. Untuk proto //some/proto/foo.proto, pengguna dapat mereferensikan kode yang dihasilkan menggunakan jalur impor some/proto/foo.j2objc.pb.h.
entry_classes	List of strings; optional Daftar class Java yang terjemahan ObjC-nya akan direferensikan langsung oleh kode ObjC pengguna. Atribut ini diperlukan jika tanda --j2objc_dead_code_removal aktif. Class Java harus ditentukan dalam nama kanonisnya seperti yang ditetapkan oleh Spesifikasi Bahasa Java. Ketika flag --j2objc_dead_code_removal ditentukan, daftar class entri akan dikumpulkan secara transitif dan digunakan sebagai titik entri untuk melakukan analisis kode mati. Class yang tidak digunakan kemudian akan dihapus dari app bundle ObjC akhir.
jre_deps	List of labels; optional Daftar library emulasi JRE tambahan yang diperlukan oleh semua kode Java yang diterjemahkan oleh aturan j2objc_library ini. Hanya fungsi JRE inti yang ditautkan secara default.

objc_import

objc_import(name, hdrs, alwayslink, archives, compatible_with, deprecation, distribs, features, includes, licenses, restricted_to, sdk_dylibs, sdk_frameworks, sdk_includes, tags, target_compatible_with, testonly, textual_hdrs, visibility, weak_sdk_frameworks)

Aturan ini mengenkapsulasi library statis yang sudah dikompilasi dalam bentuk file .a. Tindakan ini juga memungkinkan pengeksporan header dan resource menggunakan atribut yang sama yang didukung oleh objc_library.

Argumen

Atribut
name	Name; required Nama unik untuk target ini.
hdrs	List of labels; optional Daftar file header C, C++, Objective-C, dan Objective-C++ yang dipublikasikan oleh library ini untuk disertakan oleh sumber dalam aturan dependen. Header ini menjelaskan antarmuka publik untuk library dan akan tersedia untuk disertakan oleh sumber dalam aturan ini atau dalam aturan dependen. Header yang tidak dimaksudkan untuk disertakan oleh klien library ini harus dicantumkan dalam atribut srcs sebagai gantinya. Ini akan dikompilasi secara terpisah dari sumber jika modul diaktifkan.
alwayslink	Boolean; optional; default is False Jika 1, paket atau biner apa pun yang bergantung (langsung atau tidak langsung) pada library ini akan ditautkan dalam semua file objek untuk file yang tercantum dalam srcs dan non_arc_srcs, meskipun beberapa file tidak berisi simbol yang direferensikan oleh biner. Hal ini berguna jika kode Anda tidak secara eksplisit dipanggil oleh kode dalam biner, misalnya jika kode Anda mendaftar untuk menerima callback yang disediakan oleh beberapa layanan.
archives	List of labels; required Daftar file .a yang diberikan ke target Objective-C yang bergantung pada target ini.
includes	List of strings; optional Daftar #include/#import jalur penelusuran yang akan ditambahkan ke target ini dan semua target yang bergantung. Hal ini untuk mendukung library pihak ketiga dan open source yang tidak menentukan seluruh jalur ruang kerja dalam pernyataan #import/#include. Jalur tersebut ditafsirkan secara relatif terhadap direktori paket, dan root genfile dan bin (misalnya blaze-genfiles/pkg/includedir dan blaze-out/pkg/includedir) disertakan selain root klien yang sebenarnya. Tidak seperti COPTS, tanda ini ditambahkan untuk aturan ini dan setiap aturan yang bergantung padanya. (Catatan: bukan aturan yang menjadi dependensinya.) Hati-hati, karena hal ini mungkin memiliki dampak yang luas. Jika ragu, tambahkan tanda "-ikutipan" ke COPTS sebagai gantinya.
sdk_dylibs	List of strings; optional Nama library .dylib SDK yang akan ditautkan. Misalnya, "libz" atau "libarchive". "libc++" disertakan secara otomatis jika biner memiliki sumber C++ atau Objective-C++ dalam hierarki dependensinya. Saat menautkan biner, semua library yang disebutkan dalam grafik dependensi transitif biner tersebut akan digunakan.
sdk_frameworks	List of strings; optional Nama framework SDK yang akan ditautkan (mis. "AddressBook", "QuartzCore"). "UIKit" dan "Foundation" selalu disertakan saat membuat build untuk platform iOS, tvOS, dan watchOS. Untuk macOS, hanya "Foundation" yang selalu disertakan. Saat menautkan biner Apple tingkat atas, semua framework SDK yang tercantum dalam grafik dependensi transitif biner tersebut akan ditautkan.
sdk_includes	List of strings; optional Daftar jalur penelusuran #include/#import yang akan ditambahkan ke target ini dan semua target yang bergantung, dengan setiap jalur relatif terhadap $(SDKROOT)/usr/include.
textual_hdrs	List of labels; optional Daftar file C, C++, Objective-C, dan Objective-C++ yang disertakan sebagai header menurut file sumber dalam aturan ini atau oleh pengguna library ini. Tidak seperti hdr, ID ini tidak akan dikompilasi secara terpisah dari sumbernya.
weak_sdk_frameworks	List of strings; optional Nama framework SDK yang akan ditautkan secara lemah. Misalnya, "MediaAccessibility". Berbeda dengan framework SDK yang ditautkan secara rutin, simbol dari framework yang ditautkan secara lemah tidak menyebabkan error jika tidak ada saat runtime.

objc_library

objc_library(name, deps, srcs, data, hdrs, alwayslink, compatible_with, copts, defines, deprecation, distribs, enable_modules, exec_compatible_with, exec_properties, features, includes, licenses, linkopts, module_map, module_name, non_arc_srcs, pch, restricted_to, runtime_deps, sdk_dylibs, sdk_frameworks, sdk_includes, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, weak_sdk_frameworks)

Aturan ini menghasilkan library statis dari file sumber Objective-C yang ditentukan.

Argumen

Atribut
name	Name; required Nama unik untuk target ini.
deps	List of labels; optional Daftar target yang ditautkan bersama untuk membentuk paket akhir.
srcs	List of labels; optional Daftar file sumber dan header serta/atau C, C++, Objective-C, dan Objective-C++, dan/atau file sumber assembly (`.s`, `.S`, atau `.asm`), yang diproses untuk membuat target library. Ini adalah file yang Anda check in, plus semua file yang dibuat. File sumber dikompilasi ke dalam file .o dengan Clang. File header dapat disertakan/diimpor oleh sumber atau header apa pun dalam atribut srcs pada target ini, tetapi tidak oleh header dalam hdr atau target apa pun yang bergantung pada aturan ini. Selain itu, file .o yang dikompilasi sebelumnya dapat diberikan sebagai srcs. Berhati-hatilah untuk memastikan konsistensi dalam arsitektur file .o yang disediakan dan build untuk menghindari hilangnya error linker simbol.
hdrs	List of labels; optional Daftar file header C, C++, Objective-C, dan Objective-C++ yang dipublikasikan oleh library ini untuk disertakan oleh sumber dalam aturan dependen. Header ini menjelaskan antarmuka publik untuk library dan akan tersedia untuk disertakan oleh sumber dalam aturan ini atau dalam aturan dependen. Header yang tidak dimaksudkan untuk disertakan oleh klien library ini harus dicantumkan dalam atribut srcs sebagai gantinya. Ini akan dikompilasi secara terpisah dari sumber jika modul diaktifkan.
alwayslink	Boolean; optional; default is False Jika 1, paket atau biner apa pun yang bergantung (langsung atau tidak langsung) pada library ini akan ditautkan dalam semua file objek untuk file yang tercantum dalam srcs dan non_arc_srcs, meskipun beberapa file tidak berisi simbol yang direferensikan oleh biner. Hal ini berguna jika kode Anda tidak secara eksplisit dipanggil oleh kode dalam biner, misalnya jika kode Anda mendaftar untuk menerima callback yang disediakan oleh beberapa layanan.
copts	List of strings; optional Tanda tambahan untuk diteruskan ke compiler. Tunduk pada penggantian "Buat variabel" dan tokenisasi Bourne shell. Tanda ini hanya akan berlaku untuk target ini, dan bukan yang bergantung padanya, atau yang bergantung padanya. Perlu diperhatikan bahwa untuk project Xcode yang dihasilkan, jalur direktori yang ditentukan menggunakan flag "-I" dalam kode akan diuraikan, diawali dengan "$(WORKSPACE_ROOT)/" jika jalur tersebut merupakan jalur relatif, dan ditambahkan ke jalur penelusuran header untuk target Xcode terkait.
defines	List of strings; optional Tambahan tanda -D untuk diteruskan ke compiler. Flag tersebut harus berbentuk KEY=VALUE atau hanya KEY dan diteruskan tidak hanya ke compiler untuk target ini (seperti copts) tetapi juga ke semua dependensi objc_ dari target ini. Tunduk pada penggantian "Buat variabel" dan tokenisasi Bourne shell.
enable_modules	Boolean; optional; default is False Mengaktifkan dukungan modul clang (melalui -fmodules). Menyetelnya ke 1 akan memungkinkan Anda melakukan @mengimpor header sistem dan target lainnya: @import UIKit; @import path_to_package_target;
includes	List of strings; optional Daftar #include/#import jalur penelusuran yang akan ditambahkan ke target ini dan semua target yang bergantung. Hal ini untuk mendukung library pihak ketiga dan open source yang tidak menentukan seluruh jalur ruang kerja dalam pernyataan #import/#include. Jalur tersebut ditafsirkan secara relatif terhadap direktori paket, dan root genfile dan bin (misalnya blaze-genfiles/pkg/includedir dan blaze-out/pkg/includedir) disertakan selain root klien yang sebenarnya. Tidak seperti COPTS, tanda ini ditambahkan untuk aturan ini dan setiap aturan yang bergantung padanya. (Catatan: bukan aturan yang menjadi dependensinya.) Hati-hati, karena hal ini mungkin memiliki dampak yang luas. Jika ragu, tambahkan tanda "-ikutipan" ke COPTS sebagai gantinya.
linkopts	List of strings; optional Tanda tambahan untuk diteruskan ke penaut.
module_map	Label; optional Peta modul Clang kustom untuk target ini. Penggunaan peta modul kustom tidak disarankan. Sebagian besar pengguna sebaiknya menggunakan peta modul yang dibuat oleh Bazel. Jika ditentukan, Bazel tidak akan menghasilkan peta modul untuk target ini, tetapi akan meneruskan peta modul yang disediakan ke compiler.
module_name	String; optional Menetapkan nama modul untuk target ini. Secara default, nama modul adalah jalur target dengan semua simbol khusus yang diganti dengan _, misalnya, //foo/baz:bar dapat diimpor sebagai foo_baz_bar.
non_arc_srcs	List of labels; optional Daftar file Objective-C yang diproses untuk membuat target library yang TIDAK menggunakan ARC. File dalam atribut ini diperlakukan sangat mirip dengan file dalam atribut srcs, tetapi dikompilasi tanpa mengaktifkan ARC.
pch	Label; optional File header untuk ditambahkan ke setiap file sumber yang dikompilasi (baik lengkungan maupun non-arc). Penggunaan file pch secara aktif tidak disarankan dalam file BUILD, dan harus dianggap tidak digunakan lagi. Karena file pch sebenarnya tidak dikompilasi sebelumnya, ini bukanlah peningkatan kecepatan build, dan hanyalah dependensi global. Dari sudut pandang efisiensi build, Anda sebenarnya lebih baik dengan menyertakan apa yang Anda butuhkan langsung di sumber Anda di tempat yang membutuhkannya.
runtime_deps	List of labels; optional Daftar target framework yang terlambat dimuat saat runtime. Dependensi ini disertakan dalam app bundle, tetapi tidak ditautkan pada waktu build.
sdk_dylibs	List of strings; optional Nama library .dylib SDK yang akan ditautkan. Misalnya, "libz" atau "libarchive". "libc++" disertakan secara otomatis jika biner memiliki sumber C++ atau Objective-C++ dalam hierarki dependensinya. Saat menautkan biner, semua library yang disebutkan dalam grafik dependensi transitif biner tersebut akan digunakan.
sdk_frameworks	List of strings; optional Nama framework SDK yang akan ditautkan (mis. "AddressBook", "QuartzCore"). "UIKit" dan "Foundation" selalu disertakan saat membuat build untuk platform iOS, tvOS, dan watchOS. Untuk macOS, hanya "Foundation" yang selalu disertakan. Saat menautkan biner Apple tingkat atas, semua framework SDK yang tercantum dalam grafik dependensi transitif biner tersebut akan ditautkan.
sdk_includes	List of strings; optional Daftar jalur penelusuran #include/#import yang akan ditambahkan ke target ini dan semua target yang bergantung, dengan setiap jalur relatif terhadap $(SDKROOT)/usr/include.
textual_hdrs	List of labels; optional Daftar file C, C++, Objective-C, dan Objective-C++ yang disertakan sebagai header menurut file sumber dalam aturan ini atau oleh pengguna library ini. Tidak seperti hdr, ID ini tidak akan dikompilasi secara terpisah dari sumbernya.
weak_sdk_frameworks	List of strings; optional Nama framework SDK yang akan ditautkan secara lemah. Misalnya, "MediaAccessibility". Berbeda dengan framework SDK yang ditautkan secara rutin, simbol dari framework yang ditautkan secara lemah tidak menyebabkan error jika tidak ada saat runtime.

available_xcodes

available_xcodes(name, default, deprecation, distribs, features, licenses, tags, testonly, versions, visibility)

Dua target aturan ini dapat diandalkan oleh instance aturan xcode_config untuk menunjukkan versi xcode yang tersedia secara jarak jauh dan lokal. Hal ini memungkinkan pemilihan versi xcode resmi dari xcode yang tersedia secara kolektif.

Argumen

Atribut
name	Name; required Nama unik untuk target ini.
default	Label; required; nonconfigurable Versi xcode default untuk platform ini.
versions	List of labels; optional; nonconfigurable Versi xcode yang tersedia di platform ini.

xcode_config

xcode_config(name, default, deprecation, distribs, features, licenses, local_versions, remote_versions, tags, testonly, versions, visibility)

Satu target dari aturan ini dapat direferensikan oleh flag build --xcode_version_config untuk menerjemahkan flag --xcode_version ke dalam versi xcode resmi yang diterima. Hal ini memungkinkan pemilihan versi xcode resmi dari sejumlah alias yang terdaftar.

Argumen

Atribut
name	Name; required Nama unik untuk target ini.
default	Label; optional; nonconfigurable Versi resmi xcode default yang akan digunakan. Versi yang ditentukan oleh target xcode_version yang disediakan akan digunakan jika tidak ada flag build xcode_version yang ditentukan. Ini diperlukan jika ada versions yang ditetapkan. Nilai ini tidak dapat disetel jika remote_versions atau local_versions ditetapkan.
local_versions	Label; optional; nonconfigurable xcode_version targets that are available locally. These are used along with local_versions to select a mutually available version. This may not be set if versions is set.
remote_versions	Label; optional; nonconfigurable xcode_version targets that are available remotely. These are used along with remote_versions to select a mutually available version. This may not be set if versions is set.
versions	List of labels; optional; nonconfigurable xcode_version targets that may be used. If the value of the xcode_version build flag matches one of the aliases or version number of any of the given xcode_version targets, the matching target will be used. This may not be set if remote_versions or local_versions is set. diterima

xcode_version

xcode_version(name, default_ios_sdk_version, default_macos_sdk_version, default_tvos_sdk_version, default_watchos_sdk_version, deprecation, distribs, features, licenses, tags, testonly, version, visibility)

Mewakili satu versi xcode resmi dengan alias yang dapat diterima untuk versi xcode tersebut. Lihat aturan xcode_config.

Argumen

Atribut
name	Name; required Nama unik untuk target ini.
default_ios_sdk_version	String; optional; nonconfigurable Versi SDK iOS yang digunakan secara default saat Xcode versi ini sedang digunakan. Flag build ios_sdk_version akan mengganti nilai yang ditentukan di sini.
default_macos_sdk_version	String; optional; nonconfigurable Versi SDK Macosx yang digunakan secara default saat Xcode versi ini sedang digunakan. Flag build macos_sdk_version akan mengganti nilai yang ditentukan di sini.
default_tvos_sdk_version	String; optional; nonconfigurable Versi SDK TVOS yang digunakan secara default saat Xcode versi ini sedang digunakan. Flag build tvos_sdk_version akan mengganti nilai yang ditentukan di sini.
default_watchos_sdk_version	String; optional; nonconfigurable Versi SDK watchos yang digunakan secara default saat Xcode versi ini sedang digunakan. Flag build watchos_sdk_version akan mengganti nilai yang ditentukan di sini.
version	String; required; nonconfigurable Nomor versi resmi dari versi Xcode.