กฎ Objective-C

7.3 · 7.2 · 7.1 · 7.0 · 6.5

กฎ

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)

กฎนี้ใช้ J2ObjC เพื่อแปลไฟล์ต้นฉบับ Java เป็น Objective-C ซึ่งจะนำไปใช้เป็นทรัพยากร Dependency ของกฎ objc_library และ objc_binary ดูข้อมูลโดยละเอียดเกี่ยวกับ J2ObjC ได้ที่เว็บไซต์ J2ObjC

ระบุแฟล็กการเปลี่ยนรูปแบบ J2ObjC ที่กำหนดเองได้โดยใช้แฟล็กบิลด์ --j2objc_translation_flags ในบรรทัดคำสั่ง

โปรดทราบว่าไฟล์ที่แปลแล้วที่อยู่ในเป้าหมาย j2objc_library จะถูกคอมไพล์โดยใช้การกำหนดค่าการคอมไพล์เริ่มต้น ซึ่งเป็นการกำหนดค่าเดียวกันกับแหล่งที่มาของกฎ objc_library ที่ไม่ได้ระบุตัวเลือกการรวบรวมไว้ในแอตทริบิวต์

นอกจากนี้ ระบบจะกรองโค้ดที่สร้างขึ้นที่ซ้ำกันออกที่ระดับเป้าหมาย ไม่ใช่ระดับแหล่งที่มา หากมีเป้าหมาย Java 2 รายการที่แตกต่างกันซึ่งมีไฟล์ต้นทาง Java เดียวกัน คุณอาจเห็นข้อผิดพลาดเกี่ยวกับสัญลักษณ์ที่ซ้ำกันเมื่อลิงก์ วิธีที่ถูกต้องในการแก้ไขปัญหานี้คือย้ายไฟล์ซอร์สของ Java ที่แชร์ไปยังเป้าหมายทั่วไปแยกต่างหากที่อาจพึ่งพาได้

อาร์กิวเมนต์

Attributes
`name`	ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้
`deps`	รายการป้ายกํากับ ค่าเริ่มต้นคือ `[]` รายการเป้าหมาย `j2objc_library`, `java_library`, `java_import` และ `java_proto_library` ที่มีไฟล์ Java ที่จะแปลงเป็น Objective-C เป้าหมาย `java_library` และ `java_import` ทั้งหมดที่เข้าถึงได้ชั่วคราวผ่าน `exports`, `deps` และ `runtime_deps` จะได้รับการแปลและคอมไพล์ รวมถึงไฟล์ที่สร้างจากการประมวลผลคำอธิบายประกอบของ Java ระบบไม่รองรับเป้าหมาย code>java_import ที่ไม่ได้ระบุ `srcjar` การแปล J2ObjC จะทำงานแตกต่างกันไปโดยขึ้นอยู่กับประเภทของไฟล์ต้นทาง Java ที่รวมอยู่ใน Closure แบบทรานซิทีฟ สําหรับไฟล์ต้นฉบับ .java แต่ละไฟล์ที่รวมอยู่ใน `srcs` ของ `java_library` ระบบจะสร้างไฟล์ต้นฉบับ .h และ .m ที่สอดคล้องกัน สำหรับ jar แหล่งที่มาแต่ละรายการที่อยู่ใน `srcs` ของ `java_library` หรือ `srcjar` จาก `java_import` ระบบจะสร้างไฟล์ต้นฉบับ .h และ .m ที่เกี่ยวข้องขึ้นพร้อมกับโค้ดทั้งหมดสำหรับ jar นั้น ผู้ใช้จะนำเข้าไฟล์ส่วนหัวที่ J2ObjC สร้างขึ้นในโค้ดได้ เส้นทางการนําเข้าสําหรับไฟล์เหล่านี้คือเส้นทางแบบสัมพัทธ์กับรูทของอาร์ติแฟกต์ Java เดิม ตัวอย่างเช่น `//some/package/foo.java` มีเส้นทางการนําเข้าเป็น `some/package/foo.h` และ `//some/package/bar.srcjar` มี `some/package/bar.h` หากกฎ proto_library อยู่ในการปิดเชิงการเปลี่ยนรูปแบบของกฎนี้ ระบบจะสร้าง คอมไพล์ และลิงก์โปรโตคอล J2ObjC ในระดับไบนารีด้วย สำหรับ Proto `//some/proto/foo.proto` ผู้ใช้จะอ้างอิงโค้ดที่สร้างขึ้นได้โดยใช้เส้นทางการนำเข้า `some/proto/foo.j2objc.pb.h`
`entry_classes`	รายการสตริง ค่าเริ่มต้นคือ `[]` รายการคลาสของ Java ที่มีคู่ ObjC ที่แปลแล้วจะถูกอ้างอิงโดยตรงโดยโค้ด ObjC ของผู้ใช้ ต้องระบุแอตทริบิวต์นี้หากแฟล็ก `--j2objc_dead_code_removal` เปิดอยู่ คลาส Java ควรมีการระบุไว้ในชื่อ Canonical ตามที่กำหนดโดยข้อกำหนดภาษาของ Java เมื่อระบุ Flag `--j2objc_dead_code_removal` ระบบจะรวบรวมรายการคลาสรายการแรกแบบทรานซิทีฟและใช้เป็นจุดแรกเข้าเพื่อวิเคราะห์โค้ดที่ตายแล้ว จากนั้นระบบจะนำคลาสที่ไม่ได้ใช้งานออกจาก App Bundle ของ ObjC สุดท้าย
`jre_deps`	รายการป้ายกํากับ ค่าเริ่มต้นคือ `[]` รายการไลบรารีการจําลอง JRE เพิ่มเติมที่จําเป็นสําหรับโค้ด Java ทั้งหมดที่แปลโดยกฎ `j2objc_library` นี้ โดยค่าเริ่มต้น ระบบจะลิงก์เฉพาะฟังก์ชันหลักของ JRE เท่านั้น

objc_import

ดูแหล่งที่มาของกฎ

objc_import(name, deps, 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)

กฎนี้จะรวมไลบรารีแบบคงที่ที่คอมไพล์แล้วในรูปแบบไฟล์ .a ทั้งยังช่วยให้ส่งออกส่วนหัวและทรัพยากรโดยใช้แอตทริบิวต์เดียวกันกับที่ objc_library รองรับได้ด้วย

อาร์กิวเมนต์

Attributes
`name`	ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสําหรับเป้าหมายนี้
`deps`	รายการป้ายกํากับ ค่าเริ่มต้นคือ `[]` รายการของเป้าหมายที่เป้าหมายนี้ใช้อยู่
`hdrs`	รายการป้ายกำกับ ค่าเริ่มต้นคือ `[]` รายการไฟล์ส่วนหัว C, C++, Objective-C และ Objective-C++ ที่เผยแพร่โดยไลบรารีนี้ที่จะรวมโดยแหล่งที่มาในกฎที่อ้างอิง ส่วนหัวเหล่านี้อธิบายอินเทอร์เฟซสาธารณะสำหรับคลัง และจะพร้อมให้แหล่งที่มารวมไว้ในกฎนี้หรือกฎที่เกี่ยวข้อง ส่วนหัวที่ไม่ได้รวมไว้โดยไคลเอ็นต์ของไลบรารีนี้ควรแสดงอยู่ในแอตทริบิวต์ srcs แทน ระบบจะคอมไพล์ไฟล์เหล่านี้แยกจากซอร์สหากเปิดใช้โมดูล
`alwayslink`	บูลีน ค่าเริ่มต้นคือ `False` หากเป็น 1 กลุ่มหรือไบนารีใดๆ ที่ขึ้นอยู่กับ (โดยตรงหรือโดยอ้อม) ในไลบรารีนี้จะลิงก์ในไฟล์ออบเจ็กต์ทั้งหมดของไฟล์ที่แสดงอยู่ใน `srcs` และ `non_arc_srcs` แม้ว่าบางรายการจะไม่มีสัญลักษณ์ที่ไบนารีอ้างอิงก็ตาม ซึ่งมีประโยชน์ในกรณีที่โค้ดในไบนารีไม่ได้เรียกใช้โค้ดของคุณอย่างชัดเจน เช่น ในกรณีที่โค้ดลงทะเบียนเพื่อรับการเรียกกลับบางอย่างจากบริการบางอย่าง
`archives`	รายการป้ายกำกับ ต้องระบุ รายการไฟล์ `.a` รายการที่ระบุให้กับเป้าหมาย Objective-C ที่ขึ้นอยู่กับเป้าหมายนี้
`includes`	รายการสตริง ค่าเริ่มต้นคือ `[]` รายการเส้นทางการค้นหา `#include/#import` รายการที่จะเพิ่มไปยังเป้าหมายนี้และเป้าหมายทั้งหมดที่เกี่ยวข้อง การดำเนินการนี้มีไว้เพื่อรองรับไลบรารีของบุคคลที่สามและไลบรารีโอเพนซอร์สที่ไม่ได้ระบุเส้นทางของพื้นที่ทำงานทั้งหมดในคำสั่ง `#import/#include` ระบบจะแปลเส้นทางซึ่งสัมพันธ์กับไดเรกทอรีแพ็กเกจ รวมถึงรวม Genfile และรูท bin (เช่น `blaze-genfiles/pkg/includedir` และ `blaze-out/pkg/includedir`) เพิ่มเติมจากรูทจริงของไคลเอ็นต์ ซึ่งแตกต่างจาก COPTS เนื่องจากระบบจะเพิ่ม Flag เหล่านี้สำหรับกฎนี้และกฎทุกข้อที่ขึ้นอยู่กับกฎนี้ (หมายเหตุ: ไม่ใช่กฎที่ใช้กับแอตทริบิวต์) โปรดระมัดระวังให้มาก เนื่องจากอาจทำให้เกิดผลกระทบในวงกว้าง หากไม่แน่ใจ ให้เพิ่ม Flag "-iquote" ลงใน COPTS แทน
`sdk_dylibs`	รายการสตริง ค่าเริ่มต้นคือ `[]` ชื่อของไลบรารี SDK .dylib ที่จะลิงก์ด้วย เช่น "libz" หรือ "libarchive" ระบบจะรวม "libc++" โดยอัตโนมัติหากไบนารีมีซอร์ส C++ หรือ Objective-C++ ในต้นไม้ความเกี่ยวข้อง เมื่อลิงก์ไบนารี ระบบจะใช้ไลบรารีทั้งหมดที่มีชื่อในกราฟการพึ่งพาแบบเปลี่ยนผ่านของไบนารีนั้น
`sdk_frameworks`	รายการสตริง ค่าเริ่มต้นคือ `[]` ชื่อของเฟรมเวิร์ก SDK ที่จะลิงก์ด้วย (เช่น "AddressBook", "QuartzCore") ระบบจะรวม "UIKit" และ "Foundation" ไว้เสมอเมื่อสร้างสำหรับแพลตฟอร์ม iOS, tvOS, visionOS และ watchOS ส่วนใน macOS จะรวมเฉพาะ "พื้นฐาน" เสมอ เมื่อลิงก์ไบนารีของ Apple ระดับบนสุด เฟรมเวิร์ก SDK ทั้งหมดที่แสดงในกราฟทรัพยากร Dependency แบบทรานซิทีฟของไบนารีนั้นจะลิงก์กัน
`sdk_includes`	รายการสตริง ค่าเริ่มต้นคือ `[]` รายการเส้นทางการค้นหา `#include/#import` ที่จะเพิ่มลงในเป้าหมายนี้และเป้าหมายที่เกี่ยวข้องทั้งหมด โดยแต่ละเส้นทางจะสัมพันธ์กับ `$(SDKROOT)/usr/include`
`textual_hdrs`	รายการป้ายกํากับ ค่าเริ่มต้นคือ `[]` รายการไฟล์ C, C++, Objective-C และ Objective-C++ ที่รวมอยู่ในส่วนหัวโดยไฟล์ต้นฉบับในกฎนี้หรือโดยผู้ใช้ไลบรารีนี้ ซึ่งต่างจาก hdr ตรงที่ระบบจะไม่คอมไพล์เหล่านี้แยกต่างหากจาก แหล่งที่มา
`weak_sdk_frameworks`	รายการสตริง ค่าเริ่มต้นคือ `[]` ชื่อเฟรมเวิร์ก SDK ที่จะลิงก์อย่างหลวมๆ เช่น "MediaAccessibility" สัญลักษณ์จากเฟรมเวิร์กที่มีการลิงก์แบบไม่แน่นจะไม่ทำให้เกิดข้อผิดพลาดหากไม่ปรากฏขึ้นที่รันไทม์ ซึ่งแตกต่างจากเฟรมเวิร์ก SDK ที่ลิงก์เป็นประจำ

objc_library

ดูแหล่งที่มาของกฎ

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

กฎนี้จะสร้างไลบรารีแบบคงที่จากไฟล์ซอร์ส Objective-C ที่ระบุ

อาร์กิวเมนต์

Attributes
`name`	ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้
`deps`	รายการป้ายกำกับ ค่าเริ่มต้นคือ `[]` รายการเป้าหมายที่ลิงก์กันเพื่อสร้างกลุ่มเป้าหมายสุดท้าย
`srcs`	รายการป้ายกำกับ ค่าเริ่มต้นคือ `[]` รายการไฟล์ต้นทางและส่วนหัว C, C++, Objective-C และ Objective-C++ และ/หรือ (".s", ".S" หรือ ".asm") ที่ประมวลผลเพื่อสร้างเป้าหมายไลบรารี ไฟล์เหล่านี้คือไฟล์ที่เช็คอินของคุณ รวมถึงไฟล์ที่สร้างขึ้น ไฟล์ต้นฉบับจะคอมไพล์เป็นไฟล์ .o ด้วย Clang ไฟล์ส่วนหัวอาจรวม/นําเข้าโดยแหล่งที่มาหรือส่วนหัวใดก็ได้ในแอตทริบิวต์ srcs ของเป้าหมายนี้ แต่ต้องไม่รวม/นําเข้าโดยส่วนหัวใน hdrs หรือเป้าหมายใดก็ตามที่ขึ้นอยู่กับกฎนี้ นอกจากนี้ คุณอาจระบุไฟล์ .o ที่คอมไพล์ไว้ล่วงหน้าเป็น srcs ได้ด้วย โปรดตรวจสอบว่าสถาปัตยกรรมของไฟล์ .o ที่ระบุและของบิลด์มีความสอดคล้องกัน เพื่อหลีกเลี่ยงข้อผิดพลาดเกี่ยวกับสัญลักษณ์ Linker ที่ขาดหายไป
`hdrs`	รายการป้ายกำกับ ค่าเริ่มต้นคือ `[]` รายการไฟล์ส่วนหัว C, C++, Objective-C และ Objective-C++ ที่เผยแพร่โดยไลบรารีนี้เพื่อให้แหล่งที่มารวมไว้ในกฎที่เกี่ยวข้อง ส่วนหัวเหล่านี้อธิบายอินเทอร์เฟซสาธารณะสำหรับคลัง และจะพร้อมให้แหล่งที่มารวมไว้ในกฎนี้หรือกฎที่เกี่ยวข้อง ส่วนหัวที่ไม่ได้รวมไว้โดยไคลเอ็นต์ของไลบรารีนี้ควรแสดงอยู่ในแอตทริบิวต์ srcs แทน ระบบจะคอมไพล์ไฟล์เหล่านี้แยกจากซอร์สหากเปิดใช้โมดูล
`alwayslink`	บูลีน ค่าเริ่มต้นคือ `False` หากเป็น 1 หมายความว่ากลุ่มหรือไบนารีที่ขึ้นอยู่กับ (โดยตรงหรือโดยอ้อม) ไลบรารีนี้จะลิงก์ไฟล์ออบเจ็กต์ทั้งหมดของไฟล์ที่แสดงใน `srcs` และ `non_arc_srcs` แม้ว่าบางไฟล์จะไม่มีสัญลักษณ์ที่ไบนารีอ้างอิงก็ตาม วิธีนี้มีประโยชน์หากโค้ดไม่ได้มีการเรียกอย่างชัดเจนด้วยโค้ดในไบนารี เช่น หากโค้ดของคุณลงทะเบียนเพื่อรับ Callback ที่บริการบางอย่างมีให้
`copts`	รายการสตริง ค่าเริ่มต้นคือ `[]` Flag เพิ่มเติมที่จะส่งไปยังคอมไพเลอร์ ขึ้นอยู่กับการแทนที่ "MakeVariable" และการแปลงข้อมูลเป็นโทเค็นของ Bourne Shell Flag เหล่านี้จะมีผลกับเป้าหมายนี้เท่านั้น และจะไม่มีผลกับเป้าหมายที่เป้าหมายนี้ใช้อยู่หรือเป้าหมายที่ใช้เป้าหมายนี้ โปรดทราบว่าสำหรับโปรเจ็กต์ Xcode ที่สร้างขึ้น ระบบจะแยกวิเคราะห์เส้นทางไดเรกทอรีที่ระบุโดยใช้ Flag "-I" ใน copts โดยนำ "$(WORKSPACE_ROOT)/" มาไว้ข้างหน้าหากเป็นเส้นทางแบบสัมพัทธ์ และเพิ่มลงในเส้นทางการค้นหาส่วนหัวสำหรับเป้าหมาย Xcode ที่เชื่อมโยง
`defines`	รายการสตริง ค่าเริ่มต้นคือ `[]` แฟล็ก `-D` เพิ่มเติมที่จะส่งไปยังคอมไพเลอร์ โดยควรอยู่ในรูปแบบ `KEY=VALUE` หรือเพียง `KEY` และไม่เพียงแค่ส่งไปยังคอมไพเลอร์สำหรับเป้าหมายนี้ (ดังที่ `copts`) แต่รวมถึงทรัพยากร Dependency ทั้งหมดของ `objc_` ของเป้าหมายนี้ ขึ้นอยู่กับการแทนที่ "MakeVariable" และการแปลงข้อมูลเป็นโทเค็นของ Bourne Shell
`enable_modules`	บูลีน ค่าเริ่มต้นคือ `False` เปิดใช้การสนับสนุนโมดูลคำซ้ำ (ผ่าน -fmodules) การตั้งค่านี้เป็น 1 จะช่วยให้คุณ @import ส่วนหัวของระบบและเป้าหมายอื่นๆ ได้ ดังนี้ @import UIKit; @import path_to_package_target;
`implementation_deps`	รายการป้ายกํากับ ค่าเริ่มต้นคือ `[]` รายการของไลบรารีอื่นๆ ที่เป้าหมายไลบรารีอิงตาม ซึ่งแตกต่างจาก `deps` ตรงที่ส่วนหัวและเส้นทางรวมของไลบรารีเหล่านี้ (และ Dependency แบบทรานซิทีฟทั้งหมด) จะใช้สำหรับการคอมไพล์ไลบรารีนี้เท่านั้น ไม่ใช่ไลบรารีที่ขึ้นอยู่กับไลบรารีนี้ ไลบรารีที่ระบุด้วย `implementation_deps` จะยังคงลิงก์อยู่ในเป้าหมายไบนารีที่ขึ้นอยู่กับไลบรารีนี้
`includes`	รายการสตริง ค่าเริ่มต้นคือ `[]` รายการเส้นทางการค้นหา `#include/#import` รายการที่จะเพิ่มไปยังเป้าหมายนี้และเป้าหมายทั้งหมดที่เกี่ยวข้อง การดำเนินการนี้มีไว้เพื่อรองรับไลบรารีของบุคคลที่สามและไลบรารีโอเพนซอร์สที่ไม่ได้ระบุเส้นทางของพื้นที่ทำงานทั้งหมดในคำสั่ง `#import/#include` ระบบจะตีความเส้นทางตามไดเรกทอรีแพ็กเกจ และรวมรูท genfiles และ bin (เช่น `blaze-genfiles/pkg/includedir` และ `blaze-out/pkg/includedir`) ไว้นอกเหนือจากรูทไคลเอ็นต์จริง ซึ่งแตกต่างจาก COPTS เนื่องจากระบบจะเพิ่ม Flag เหล่านี้สำหรับกฎนี้และกฎทุกข้อที่ขึ้นอยู่กับกฎนี้ (หมายเหตุ: ไม่ใช่กฎที่ใช้กับแอตทริบิวต์) โปรดใช้ความระมัดระวังอย่างยิ่ง เนื่องจากการดำเนินการนี้อาจมีผลที่ตามมาอย่างกว้างขวาง หากไม่แน่ใจ ให้เพิ่ม Flag "-iquote" ลงใน COPTS แทน
`linkopts`	รายการสตริง ค่าเริ่มต้นคือ `[]` Flag เพิ่มเติมที่จะส่งไปยัง linker
`module_map`	ป้ายกํากับ ค่าเริ่มต้นคือ `None` แมปโมดูล Clang ที่กำหนดเองของเป้าหมายนี้ ไม่แนะนําให้ใช้แผนที่โมดูลที่กําหนดเอง ผู้ใช้ส่วนใหญ่ควรใช้แผนที่โมดูลที่สร้างโดย Bazel หากระบุไว้ Bazel จะไม่สร้างแผนที่โมดูลสําหรับเป้าหมายนี้ แต่จะส่งแผนที่โมดูลที่ระบุไปยังคอมไพเลอร์
`module_name`	สตริง ค่าเริ่มต้นคือ `""` ตั้งชื่อโมดูลสำหรับเป้าหมายนี้ โดยค่าเริ่มต้น ชื่อโมดูลคือเส้นทางเป้าหมายที่มีสัญลักษณ์พิเศษทั้งหมดแทนที่ด้วย _ เช่น //foo/baz:bar จะนําเข้าเป็น foo_baz_bar ได้
`non_arc_srcs`	รายการป้ายกำกับ ค่าเริ่มต้นคือ `[]` รายการไฟล์ Objective-C ที่ประมวลผลเพื่อสร้างเป้าหมายไลบรารีที่ "ไม่ใช้ ARC" ระบบจะจัดการไฟล์ในแอตทริบิวต์นี้คล้ายกับไฟล์ในแอตทริบิวต์ srcs แต่คอมไพล์โดยไม่ได้เปิดใช้ ARC
`pch`	ป้ายกํากับ ค่าเริ่มต้นคือ `None` ไฟล์ส่วนหัวที่จะเพิ่มไว้ที่ด้านหน้าของไฟล์ต้นฉบับทุกไฟล์ที่จะคอมไพล์ (ทั้งไฟล์ ARC และไฟล์ที่ไม่ใช่ ARC) เราขอแนะนำอย่างยิ่งว่าอย่าใช้ไฟล์ pch ในไฟล์ BUILD และควรเลิกใช้งานไฟล์ประเภทนี้ จริงๆ แล้วไฟล์ pch ไม่ได้คอมไพล์ไว้ล่วงหน้า จึงไม่ใช่การเพิ่มประสิทธิภาพความเร็วของบิลด์ และเป็นเพียงทรัพยากร Dependency ทั่วโลกเท่านั้น จากมุมมองด้านประสิทธิภาพการสร้าง คุณควรใส่สิ่งที่ต้องการในแหล่งที่มาโดยตรง
`sdk_dylibs`	รายการสตริง ค่าเริ่มต้นคือ `[]` ชื่อของไลบรารี SDK .dylib ที่จะลิงก์ด้วย เช่น "libz" หรือ "libarchive" ระบบจะรวม "libc++" โดยอัตโนมัติหากไบนารีมีซอร์ส C++ หรือ Objective-C++ ในต้นไม้ความเกี่ยวข้อง เมื่อลิงก์ไบนารี ระบบจะใช้ไลบรารีทั้งหมดที่มีชื่อในกราฟการพึ่งพาแบบเปลี่ยนผ่านของไบนารีนั้น
`sdk_frameworks`	รายการสตริง ค่าเริ่มต้นคือ `[]` ชื่อของเฟรมเวิร์ก SDK ที่จะลิงก์ด้วย (เช่น "AddressBook", "QuartzCore") ระบบจะรวม "UIKit" และ "Foundation" ไว้เสมอเมื่อสร้างสำหรับแพลตฟอร์ม iOS, tvOS, visionOS และ watchOS ส่วนใน macOS จะรวมเฉพาะ "พื้นฐาน" เสมอ เมื่อลิงก์ไบนารีของ Apple ระดับบนสุด เฟรมเวิร์ก SDK ทั้งหมดที่แสดงในกราฟทรัพยากร Dependency แบบทรานซิทีฟของไบนารีนั้นจะลิงก์กัน
`sdk_includes`	รายการสตริง ค่าเริ่มต้นคือ `[]` รายการเส้นทางการค้นหา `#include/#import` ที่จะเพิ่มลงในเป้าหมายนี้และเป้าหมายที่เกี่ยวข้องทั้งหมด โดยแต่ละเส้นทางจะสัมพันธ์กับ `$(SDKROOT)/usr/include`
`textual_hdrs`	รายการป้ายกำกับ ค่าเริ่มต้นคือ `[]` รายการไฟล์ C, C++, Objective-C และ Objective-C++ ที่รวมอยู่ในส่วนหัวโดยไฟล์ต้นฉบับในกฎนี้หรือโดยผู้ใช้ไลบรารีนี้ ซึ่งจะไม่ได้รับการคอมไพล์แยกจากแหล่งที่มา ต่างจาก hdr
`weak_sdk_frameworks`	รายการสตริง ค่าเริ่มต้นคือ `[]` ชื่อของเฟรมเวิร์ก SDK ที่จะลิงก์ด้วยเล็กน้อย เช่น "MediaAccessibility" สัญลักษณ์จากเฟรมเวิร์กที่มีการลิงก์อย่างอ่อนไม่ให้เกิดข้อผิดพลาดหากไม่ได้แสดงอยู่ขณะรันไทม์ ซึ่งแตกต่างจากเฟรมเวิร์ก SDK ที่ลิงก์ตามปกติ

available_xcodes

ดูแหล่งที่มาของกฎ

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

อินสแตนซ์กฎ xcode_config สามารถใช้เป้าหมาย 2 รายการของกฎนี้เพื่อบ่งบอกเวอร์ชัน Xcode ที่พร้อมใช้งานจากระยะไกลและในเครื่อง ซึ่งจะช่วยให้เลือกเวอร์ชัน xcode อย่างเป็นทางการจาก xcode ที่มีร่วมกันได้

อาร์กิวเมนต์

Attributes

name

ชื่อ ต้องระบุ

ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้

default

ป้ายกำกับ ไม่สามารถกำหนดค่าได้ ต้องระบุ

เวอร์ชันเริ่มต้นของ Xcode สำหรับแพลตฟอร์มนี้

versions

รายการป้ายกำกับ nonconfigurable ค่าเริ่มต้นคือ []

เวอร์ชัน Xcode ที่พร้อมใช้งานบนแพลตฟอร์มนี้

xcode_config

ดูแหล่งที่มาของกฎ

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

เป้าหมายเดียวของกฎนี้ใช้อ้างอิงได้ด้วยแฟล็กบิลด์ --xcode_version_config เพื่อแปลแฟล็ก --xcode_version เป็นเวอร์ชัน xcode อย่างเป็นทางการที่ยอมรับ ซึ่งจะทำให้เลือกเวอร์ชัน xcode อย่างเป็นทางการจากนามแฝงที่ลงทะเบียนจำนวนหนึ่งได้

อาร์กิวเมนต์

Attributes
`name`	ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้
`default`	ป้ายกำกับ ไม่สามารถกำหนดค่าได้ ค่าเริ่มต้นคือ `None` xcode เวอร์ชันอย่างเป็นทางการเริ่มต้นที่จะใช้ ระบบจะใช้เวอร์ชันที่เป้าหมาย `xcode_version` ที่ระบุระบุไว้หากไม่ได้ระบุแฟล็กบิลด์ `xcode_version` ต้องระบุค่านี้หากมีการตั้งค่า `versions` ไว้ ระบบอาจตั้งค่านี้ไม่ได้หากมีการตั้งค่า `remote_versions` หรือ `local_versions`
`local_versions`	ป้ายกำกับ ไม่สามารถกำหนดค่าได้ ค่าเริ่มต้นคือ `None` เป้าหมาย `xcode_version` ที่พร้อมใช้งานในพื้นที่ ซึ่งจะใช้ร่วมกับ `local_versions` เพื่อเลือกเวอร์ชันที่ใช้ร่วมกันได้ ระบบอาจไม่ได้ตั้งค่านี้หากตั้งค่า `versions` ไว้
`remote_versions`	ป้ายกำกับ ไม่สามารถกำหนดค่าได้ ค่าเริ่มต้นคือ `None` เป้าหมาย `xcode_version` ที่พร้อมใช้งานจากระยะไกล ซึ่งจะใช้ร่วมกับ `remote_versions` เพื่อเลือกเวอร์ชันที่ใช้ร่วมกันได้ ระบบอาจไม่ได้ตั้งค่านี้หากตั้งค่า `versions` ไว้
`versions`	รายการป้ายกำกับ nonconfigurable ค่าเริ่มต้นคือ `[]` ยอมรับ `xcode_version` เป้าหมายที่สามารถนำไปใช้ หากค่าของ Flag การสร้าง `xcode_version` ตรงกับอีเมลแทนหรือหมายเลขเวอร์ชันของเป้าหมาย `xcode_version` ที่ระบุ ระบบจะใช้เป้าหมายที่ตรงกัน ระบบอาจไม่ได้ตั้งค่านี้หากมีการตั้งค่า `remote_versions` หรือ `local_versions`

xcode_version

ดูแหล่งที่มาของกฎ

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

แสดง Xcode เวอร์ชันอย่างเป็นทางการเวอร์ชันเดียวที่มีชื่อแทนที่ยอมรับได้สำหรับ Xcode เวอร์ชันนั้น ดูกฎ xcode_config

อาร์กิวเมนต์

Attributes
`name`	ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้
`default_ios_sdk_version`	สตริง nonconfigurable ค่าเริ่มต้นคือ `""` เวอร์ชัน ios sdk ที่ใช้โดยค่าเริ่มต้นเมื่อใช้ Xcode เวอร์ชันนี้ แฟล็กบิลด์ `ios_sdk_version` จะลบล้างค่าที่ระบุไว้ที่นี่
`default_macos_sdk_version`	สตริง ไม่สามารถกําหนดค่าได้ ค่าเริ่มต้นคือ `""` เวอร์ชัน SDK ของ Macosx ที่ใช้โดยค่าเริ่มต้นเมื่อมีการใช้ xcode เวอร์ชันนี้ Flag การสร้าง `macos_sdk_version` จะลบล้างค่าที่ระบุไว้ที่นี่
`default_tvos_sdk_version`	สตริง nonconfigurable ค่าเริ่มต้นคือ `""` เวอร์ชัน tvos sdk ที่ใช้โดยค่าเริ่มต้นเมื่อใช้ xcode เวอร์ชันนี้ Flag การสร้าง `tvos_sdk_version` จะลบล้างค่าที่ระบุไว้ที่นี่
`default_visionos_sdk_version`	สตริง nonconfigurable ค่าเริ่มต้นคือ `""` เวอร์ชัน SDK ของ Vision ที่ใช้โดยค่าเริ่มต้นเมื่อมีการใช้ xcode เวอร์ชันนี้ Flag การสร้าง `visionos_sdk_version` จะลบล้างค่าที่ระบุไว้ที่นี่
`default_watchos_sdk_version`	สตริง ไม่สามารถกําหนดค่าได้ ค่าเริ่มต้นคือ `""` เวอร์ชัน SDK ของ Watchos ที่ใช้โดยค่าเริ่มต้นเมื่อมีการใช้ xcode เวอร์ชันนี้ แฟล็กบิลด์ `watchos_sdk_version` จะลบล้างค่าที่ระบุไว้ที่นี่
`version`	String; nonconfigurable; ต้องระบุ หมายเลขเวอร์ชันอย่างเป็นทางการของ Xcode เวอร์ชัน