Quy tắc Objective-C

Báo cáo vấn đề Xem nguồn Nightly · 8.0 · 7.4 · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Quy tắc

• objc_import
• objc_library

objc_import

Xem nguồn quy tắc

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

Quy tắc này đóng gói một thư viện tĩnh đã biên dịch ở dạng tệp .a. Phương thức này cũng cho phép xuất tiêu đề và tài nguyên bằng cách sử dụng các thuộc tính mà objc_library hỗ trợ.

Đối số

Thuộc tính
name	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
deps	Danh sách nhãn; mặc định là [] Danh sách các mục tiêu mà mục tiêu này phụ thuộc vào.
hdrs	Danh sách nhãn; mặc định là [] Danh sách các tệp tiêu đề C, C++, Objective-C và Objective-C++ do thư viện này phát hành để các nguồn đưa vào các quy tắc phụ thuộc. Các tiêu đề này mô tả giao diện công khai cho thư viện và sẽ được cung cấp để đưa vào bởi các nguồn trong quy tắc này hoặc trong các quy tắc phụ thuộc. Các tiêu đề không dành cho ứng dụng của thư viện này nên được liệt kê trong thuộc tính srcs. Các tệp này sẽ được biên dịch riêng biệt với nguồn nếu bạn bật mô-đun.
alwayslink	Boolean; mặc định là False Nếu là 1, mọi gói hoặc tệp nhị phân phụ thuộc (trực tiếp hoặc gián tiếp) vào thư viện này sẽ liên kết với tất cả tệp đối tượng cho các tệp được liệt kê trong srcs và non_arc_srcs, ngay cả khi một số tệp không chứa ký hiệu nào được tệp nhị phân tham chiếu. Điều này hữu ích nếu mã của bạn không được mã trong tệp nhị phân gọi một cách rõ ràng, ví dụ: nếu mã của bạn đăng ký nhận một số lệnh gọi lại do một số dịch vụ cung cấp.
archives	Danh sách nhãn; bắt buộc Danh sách các tệp .a được cung cấp cho các mục tiêu Objective-C phụ thuộc vào mục tiêu này.
includes	Danh sách chuỗi; mặc định là [] Danh sách đường dẫn tìm kiếm #include/#import để thêm vào mục tiêu này và tất cả các mục tiêu phụ thuộc. Điều này là để hỗ trợ các thư viện nguồn mở và bên thứ ba không chỉ định toàn bộ đường dẫn không gian làm việc trong câu lệnh #import/#include. Các đường dẫn được diễn giải tương ứng với thư mục gói, đồng thời các genfiles và thư mục gốc bin (ví dụ: blaze-genfiles/pkg/includedir và blaze-out/pkg/includedir) được đưa vào ngoài thư mục gốc thực tế của ứng dụng. Không giống như COPTS, các cờ này được thêm vào quy tắc này và mọi quy tắc phụ thuộc vào quy tắc này. (Lưu ý: không phải là các quy tắc mà nó phụ thuộc vào!) Hãy cực kỳ cẩn thận vì việc này có thể gây ra những hậu quả sâu rộng. Nếu bạn không chắc chắn, hãy thêm cờ "-iquote" vào COPTS.
sdk_dylibs	Danh sách chuỗi; mặc định là [] Tên của các thư viện .dylib SDK cần liên kết. Ví dụ: "libz" hoặc "libarchive". "libc++" được đưa vào tự động nếu tệp nhị phân có bất kỳ nguồn C++ hoặc Objective-C++ nào trong cây phần phụ thuộc. Khi liên kết một tệp nhị phân, tất cả thư viện được đặt tên trong biểu đồ phần phụ thuộc bắc cầu của tệp nhị phân đó sẽ được sử dụng.
sdk_frameworks	Danh sách chuỗi; mặc định là [] Tên của các khung SDK để liên kết (ví dụ: "AddressBook", "QuartzCore"). Khi liên kết tệp nhị phân cấp cao nhất của Apple, tất cả khung SDK được liệt kê trong biểu đồ phần phụ thuộc bắc cầu của tệp nhị phân đó sẽ được liên kết.
sdk_includes	Danh sách chuỗi; mặc định là [] Danh sách đường dẫn tìm kiếm #include/#import để thêm vào mục tiêu này và tất cả các mục tiêu phụ thuộc, trong đó mỗi đường dẫn tương ứng với $(SDKROOT)/usr/include.
textual_hdrs	Danh sách nhãn; mặc định là [] Danh sách các tệp C, C++, Objective-C và Objective-C++ được đưa vào dưới dạng tiêu đề bởi các tệp nguồn trong quy tắc này hoặc bởi người dùng thư viện này. Không giống như hdr, các tệp này sẽ không được biên dịch riêng biệt với các nguồn.
weak_sdk_frameworks	Danh sách chuỗi; mặc định là [] Tên của các khung SDK để liên kết yếu. Ví dụ: "MediaAccessibility". Khác với các khung SDK được liên kết thường xuyên, các biểu tượng từ các khung được liên kết yếu sẽ không gây ra lỗi nếu không xuất hiện trong thời gian chạy.

objc_library

Xem nguồn quy tắc

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, linkopts, module_map, module_name, non_arc_srcs, pch, restricted_to, sdk_dylibs, sdk_frameworks, sdk_includes, stamp, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, weak_sdk_frameworks)

Quy tắc này tạo một thư viện tĩnh từ các tệp nguồn Objective-C đã cho.

Đối số

Thuộc tính
name	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
deps	Danh sách nhãn; mặc định là [] Danh sách các mục tiêu mà mục tiêu này phụ thuộc vào.
srcs	Danh sách nhãn; mặc định là [] Danh sách các tệp nguồn và tiêu đề C, C++, Objective-C và Objective-C++, và/hoặc tệp nguồn tập hợp (`.s`, `.S` hoặc `.asm`) được xử lý để tạo mục tiêu thư viện. Đây là các tệp đã kiểm tra cùng với mọi tệp được tạo. Các tệp nguồn được biên dịch thành tệp .o bằng Clang. Tệp tiêu đề có thể được đưa vào/nhập bằng bất kỳ nguồn hoặc tiêu đề nào trong thuộc tính srcs của mục tiêu này, nhưng không được đưa vào bằng tiêu đề trong hdrs hoặc bất kỳ mục tiêu nào phụ thuộc vào quy tắc này. Ngoài ra, các tệp .o được biên dịch trước có thể được cung cấp dưới dạng src. Hãy cẩn thận để đảm bảo tính nhất quán trong cấu trúc của các tệp .o được cung cấp và cấu trúc của bản dựng để tránh thiếu lỗi trình liên kết biểu tượng.
hdrs	Danh sách nhãn; mặc định là [] Danh sách các tệp tiêu đề C, C++, Objective-C và Objective-C++ do thư viện này phát hành để các nguồn đưa vào các quy tắc phụ thuộc. Các tiêu đề này mô tả giao diện công khai cho thư viện và sẽ được cung cấp để đưa vào bởi các nguồn trong quy tắc này hoặc trong các quy tắc phụ thuộc. Các tiêu đề không dành cho ứng dụng của thư viện này nên được liệt kê trong thuộc tính srcs. Các tệp này sẽ được biên dịch riêng biệt với nguồn nếu bạn bật mô-đun.
alwayslink	Boolean; mặc định là False Nếu là 1, mọi gói hoặc tệp nhị phân phụ thuộc (trực tiếp hoặc gián tiếp) vào thư viện này sẽ liên kết với tất cả tệp đối tượng cho các tệp được liệt kê trong srcs và non_arc_srcs, ngay cả khi một số tệp không chứa ký hiệu nào được tệp nhị phân tham chiếu. Điều này hữu ích nếu mã của bạn không được mã trong tệp nhị phân gọi một cách rõ ràng, ví dụ: nếu mã của bạn đăng ký nhận một số lệnh gọi lại do một số dịch vụ cung cấp.
copts	Danh sách chuỗi; mặc định là [] Các cờ bổ sung để truyền đến trình biên dịch. Chịu sự thay thế "Tạo biến" và tạo mã thông báo shell Bourne. Các cờ này sẽ chỉ áp dụng cho mục tiêu này, chứ không áp dụng cho các mục tiêu mà mục tiêu này phụ thuộc vào hoặc các mục tiêu phụ thuộc vào mục tiêu này. Xin lưu ý rằng đối với dự án Xcode được tạo, các đường dẫn thư mục được chỉ định bằng cờ "-I" trong copts sẽ được phân tích cú pháp, thêm vào "$(WORKSPACE_ROOT)/" nếu đó là đường dẫn tương đối và thêm vào đường dẫn tìm kiếm tiêu đề cho mục tiêu Xcode được liên kết.
defines	Danh sách chuỗi; mặc định là [] Các cờ -D bổ sung để truyền đến trình biên dịch. Các đối tượng này phải ở dạng KEY=VALUE hoặc đơn giản là KEY và không chỉ được truyền đến trình biên dịch cho mục tiêu này (như copts) mà còn được truyền đến tất cả phần phụ thuộc objc_ của mục tiêu này. Chịu sự thay thế "Tạo biến" và tạo mã thông báo shell Bourne.
enable_modules	Boolean; mặc định là False Bật tính năng hỗ trợ mô-đun clang (thông qua -fmodules). Việc đặt giá trị này thành 1 sẽ cho phép bạn @import các tiêu đề hệ thống và các mục tiêu khác: @import UIKit; @import path_to_package_target;
implementation_deps	Danh sách nhãn; mặc định là [] Danh sách các thư viện khác mà mục tiêu thư viện phụ thuộc vào. Không giống như deps, các tiêu đề và đường dẫn bao gồm của các thư viện này (và tất cả phần phụ thuộc bắc cầu của chúng) chỉ được dùng để biên dịch thư viện này chứ không phải các thư viện phụ thuộc vào thư viện này. Các thư viện được chỉ định bằng implementation_deps vẫn được liên kết trong các mục tiêu nhị phân phụ thuộc vào thư viện này.
includes	Danh sách chuỗi; mặc định là [] Danh sách đường dẫn tìm kiếm #include/#import để thêm vào mục tiêu này và tất cả các mục tiêu phụ thuộc. Điều này là để hỗ trợ các thư viện nguồn mở và bên thứ ba không chỉ định toàn bộ đường dẫn không gian làm việc trong câu lệnh #import/#include. Các đường dẫn được diễn giải tương ứng với thư mục gói, đồng thời các genfiles và thư mục gốc bin (ví dụ: blaze-genfiles/pkg/includedir và blaze-out/pkg/includedir) được đưa vào ngoài thư mục gốc thực tế của ứng dụng. Không giống như COPTS, các cờ này được thêm vào quy tắc này và mọi quy tắc phụ thuộc vào quy tắc này. (Lưu ý: không phải là các quy tắc mà nó phụ thuộc vào!) Hãy cực kỳ cẩn thận vì việc này có thể gây ra những hậu quả sâu rộng. Nếu bạn không chắc chắn, hãy thêm cờ "-iquote" vào COPTS.
linkopts	Danh sách chuỗi; mặc định là [] Các cờ bổ sung để truyền đến trình liên kết.
module_map	Nhãn; mặc định là None bản đồ mô-đun Clang tuỳ chỉnh cho mục tiêu này. Bạn không nên sử dụng bản đồ mô-đun tuỳ chỉnh. Hầu hết người dùng nên sử dụng bản đồ mô-đun do Bazel tạo. Nếu được chỉ định, Bazel sẽ không tạo bản đồ mô-đun cho mục tiêu này, nhưng sẽ chuyển bản đồ mô-đun được cung cấp đến trình biên dịch.
module_name	Chuỗi; mặc định là "" Đặt tên mô-đun cho mục tiêu này. Theo mặc định, tên mô-đun là đường dẫn đích với tất cả các ký hiệu đặc biệt được thay thế bằng _, ví dụ: //foo/baz:bar có thể được nhập dưới dạng foo_baz_bar.
non_arc_srcs	Danh sách nhãn; mặc định là [] Danh sách các tệp Objective-C được xử lý để tạo mục tiêu thư viện KHÔNG sử dụng ARC. Các tệp trong thuộc tính này được xử lý rất giống với các tệp trong thuộc tính srcs, nhưng được biên dịch mà không bật ARC.
pch	Nhãn; mặc định là None Tệp tiêu đề để thêm vào đầu mọi tệp nguồn đang được biên dịch (cả arc và không phải arc). Bạn không nên sử dụng tệp pch trong tệp BUILD và việc này nên được coi là không dùng nữa. Vì các tệp pch không thực sự được biên dịch trước nên đây không phải là tính năng tăng tốc độ xây dựng mà chỉ là một phần phụ thuộc toàn cục. Từ quan điểm về hiệu quả xây dựng, bạn nên đưa những gì cần thiết vào trực tiếp trong nguồn của mình khi cần.
sdk_dylibs	Danh sách chuỗi; mặc định là [] Tên của các thư viện .dylib SDK cần liên kết. Ví dụ: "libz" hoặc "libarchive". "libc++" được đưa vào tự động nếu tệp nhị phân có bất kỳ nguồn C++ hoặc Objective-C++ nào trong cây phần phụ thuộc. Khi liên kết một tệp nhị phân, tất cả thư viện được đặt tên trong biểu đồ phần phụ thuộc bắc cầu của tệp nhị phân đó sẽ được sử dụng.
sdk_frameworks	Danh sách chuỗi; mặc định là [] Tên của các khung SDK để liên kết (ví dụ: "AddressBook", "QuartzCore"). Khi liên kết tệp nhị phân cấp cao nhất của Apple, tất cả khung SDK được liệt kê trong biểu đồ phần phụ thuộc bắc cầu của tệp nhị phân đó sẽ được liên kết.
sdk_includes	Danh sách chuỗi; mặc định là [] Danh sách đường dẫn tìm kiếm #include/#import để thêm vào mục tiêu này và tất cả các mục tiêu phụ thuộc, trong đó mỗi đường dẫn tương ứng với $(SDKROOT)/usr/include.
stamp	Boolean; mặc định là False
textual_hdrs	Danh sách nhãn; mặc định là [] Danh sách các tệp C, C++, Objective-C và Objective-C++ được đưa vào dưới dạng tiêu đề bởi các tệp nguồn trong quy tắc này hoặc bởi người dùng thư viện này. Không giống như hdr, các tệp này sẽ không được biên dịch riêng biệt với các nguồn.
weak_sdk_frameworks	Danh sách chuỗi; mặc định là [] Tên của các khung SDK để liên kết yếu. Ví dụ: "MediaAccessibility". Khác với các khung SDK được liên kết thường xuyên, các biểu tượng từ các khung được liên kết yếu sẽ không gây ra lỗi nếu không xuất hiện trong thời gian chạy.