Objective-C 규칙

문제 신고 소스 보기 Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

규칙

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로 변환한 다음 objc_library 및 objc_binary 규칙의 종속 항목으로 사용할 수 있습니다. J2ObjC 자체에 관한 자세한 내용은 J2ObjC 사이트에서 확인할 수 있습니다.

커스텀 J2ObjC 변환 플래그는 명령줄에서 빌드 플래그 --j2objc_translation_flags를 사용하여 지정할 수 있습니다.

j2objc_library 타겟에 포함된 번역된 파일은 기본 컴파일 구성(속성에 지정된 컴파일 옵션이 없는 objc_library 규칙의 소스와 동일한 구성)을 사용하여 컴파일됩니다.

또한 생성된 코드는 소스 수준이 아닌 타겟 수준에서 중복 삭제됩니다. 동일한 Java 소스 파일을 포함하는 두 개의 서로 다른 Java 타겟이 있는 경우 링크 시간에 중복 기호 오류가 표시될 수 있습니다. 이 문제를 해결하는 올바른 방법은 공유된 Java 소스 파일을 신뢰할 수 있는 별도의 공통 타겟으로 이동하는 것입니다.

인수

속성
name

이름: 필수사항

이 타겟의 고유한 이름입니다.

deps

라벨 목록입니다. 기본값은 []입니다.

Objective-C로 트랜스파일할 Java 파일이 포함된 j2objc_library, java_library, java_import, java_proto_library 타겟 목록입니다.

exports, deps, runtime_deps를 통해 전이적으로 도달할 수 있는 모든 java_libraryjava_import 타겟은 Java 주석 처리에서 생성된 파일을 포함하여 변환되고 컴파일됩니다. 지정된 srcjar가 없는 code>java_import 타겟은 지원되지 않습니다.

J2ObjC 변환은 전이 폐쇄에 포함된 소스 Java 소스 파일의 유형에 따라 다르게 작동합니다. java_librarysrcs에 포함된 각 .java 소스 파일에 대해 상응하는 .h 및 .m 소스 파일이 생성됩니다. java_librarysrcs 또는 java_importsrcjar에 포함된 각 소스 jar에 대해 해당 jar의 모든 코드와 함께 상응하는 .h 및 .m 소스 파일이 생성됩니다.

사용자는 코드에서 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

문자열 목록입니다. 기본값은 []입니다.

번역된 ObjC 대응 요소가 사용자 ObjC 코드에 의해 직접 참조되는 Java 클래스의 목록입니다. --j2objc_dead_code_removal 플래그가 켜져 있는 경우 이 속성은 필수입니다. Java 클래스는 Java 언어 사양에 정의된 대로 표준 이름으로 지정해야 합니다. 플래그 --j2objc_dead_code_removal가 지정되면 진입 클래스 목록이 전이적으로 수집되고 비활성 코드 분석을 실행하는 진입점으로 사용됩니다. 그러면 사용하지 않는 클래스가 최종 ObjC 앱 번들에서 삭제됩니다.
jre_deps

라벨 목록. 기본값은 []입니다.

j2objc_library 규칙으로 변환된 모든 Java 코드에 필요한 추가 JRE 에뮬레이션 라이브러리의 목록입니다. 기본적으로 핵심 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에서 지원하는 동일한 속성을 사용하여 헤더와 리소스를 내보낼 수 있습니다.

인수

속성
name

이름: 필수사항

이 타겟의 고유한 이름입니다.

deps

라벨 목록입니다. 기본값은 []입니다.

이 타겟이 종속되는 타겟 목록입니다.
hdrs

라벨 목록. 기본값은 []입니다.

이 라이브러리에서 게시하여 종속 규칙의 소스에 포함할 C, C++, Objective-C, Objective-C++ 헤더 파일의 목록입니다.

이러한 헤더는 라이브러리의 공개 인터페이스를 설명하며, 소스가 이 규칙 또는 종속 규칙에 포함할 수 있도록 제공됩니다. 이 라이브러리의 클라이언트가 포함하지 않아야 하는 헤더는 대신 srcs 속성에 나열해야 합니다.

모듈이 사용 설정된 경우 소스와 별도로 컴파일됩니다.

불리언. 기본값은 False입니다.

1이면 이 라이브러리에 직접 또는 간접적으로 종속되는 모든 번들 또는 바이너리가 바이너리에서 참조하는 기호가 포함되어 있지 않더라도 srcsnon_arc_srcs에 나열된 파일의 모든 객체 파일에서 링크됩니다. 이는 코드가 바이너리의 코드에 의해 명시적으로 호출되지 않는 경우에 유용합니다. 예를 들어 코드가 서비스에서 제공하는 콜백을 수신하도록 등록하는 경우입니다.
archives

라벨 목록(필수)

이 타겟에 종속된 Objective-C 타겟에 제공된 .a 파일 목록입니다.
includes

문자열 목록입니다. 기본값은 []입니다.

이 타겟 및 모든 종속 타겟에 추가할 #include/#import 검색 경로 목록입니다. 이는 #import/#include 문에 전체 워크스페이스 경로를 지정하지 않는 서드 파티 및 오픈소스 라이브러리를 지원하기 위한 것입니다.

경로는 패키지 디렉터리에 대해 상대적으로 해석되며 실제 클라이언트 루트 외에도 genfiles 및 bin 루트(예: blaze-genfiles/pkg/includedirblaze-out/pkg/includedir)가 포함됩니다.

COPTS와 달리 이러한 플래그는 이 규칙과 이 규칙에 종속되는 모든 규칙에 추가됩니다. (참고: 종속되는 규칙이 아닙니다.) 이는 광범위한 영향을 미칠 수 있으므로 주의하세요. 확실하지 않은 경우에는 대신 '-iquote' 플래그를 COPTS에 추가하세요.

sdk_dylibs

문자열 목록. 기본값은 []입니다.

연결할 SDK .dylib 라이브러리의 이름입니다. 예를 들어 'libz' 또는 'libarchive'가 있습니다. 바이너리의 종속 항목 트리에 C++ 또는 Objective-C++ 소스가 있는 경우 'libc++'가 자동으로 포함됩니다. 바이너리를 연결할 때 해당 바이너리의 전이 종속 항목 그래프에 이름이 지정된 모든 라이브러리가 사용됩니다.
sdk_frameworks

문자열 목록. 기본값은 []입니다.

연결할 SDK 프레임워크의 이름입니다(예: 'AddressBook', 'QuartzCore'). 'UIKit' 및 'Foundation'은 iOS, tvOS, visionOS, watchOS 플랫폼용으로 빌드할 때 항상 포함됩니다. macOS의 경우 항상 'Foundation'만 포함됩니다.

최상위 Apple 바이너리를 연결하면 해당 바이너리의 전이 종속 항목 그래프에 나열된 모든 SDK 프레임워크가 연결됩니다.

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 소스 파일에서 정적 라이브러리를 생성합니다.

인수

속성
name

이름: 필수사항

이 타겟의 고유한 이름입니다.

deps

라벨 목록입니다. 기본값은 []입니다.

최종 번들을 형성하기 위해 서로 연결된 타겟 목록입니다.
srcs

라벨 목록입니다. 기본값은 []입니다.

라이브러리 타겟을 생성하기 위해 처리되는 C, C++, Objective-C, Objective-C++ 소스 및 헤더 파일 또는 (`.s`, `.S` 또는 `.asm`) 어셈블리 소스 파일의 목록입니다. 체크인된 파일과 생성된 파일입니다. 소스 파일은 Clang을 사용하여 .o 파일로 컴파일됩니다. 헤더 파일은 이 타겟의 srcs 속성의 소스 또는 헤더에 의해 포함/가져올 수 있지만 hdrs의 헤더 또는 이 규칙에 종속된 타겟에 의해 포함/가져올 수는 없습니다. 또한 사전 컴파일된 .o 파일을 src로 제공할 수 있습니다. 제공된 .o 파일의 아키텍처와 빌드의 아키텍처가 일관되도록 주의하여 기호 링커 오류가 발생하지 않도록 합니다.
hdrs

라벨 목록. 기본값은 []입니다.

이 라이브러리에서 게시하여 종속 규칙의 소스에 포함할 C, C++, Objective-C, Objective-C++ 헤더 파일의 목록입니다.

이러한 헤더는 라이브러리의 공개 인터페이스를 설명하며, 소스가 이 규칙 또는 종속 규칙에 포함할 수 있도록 제공됩니다. 이 라이브러리의 클라이언트가 포함하지 않아야 하는 헤더는 대신 srcs 속성에 나열해야 합니다.

모듈이 사용 설정된 경우 소스와 별도로 컴파일됩니다.

불리언. 기본값은 False입니다.

1이면 이 라이브러리에 직접 또는 간접적으로 종속되는 모든 번들 또는 바이너리는 srcsnon_arc_srcs에 나열된 파일의 모든 객체 파일을 링크합니다(일부 파일에 바이너리에서 참조하는 기호가 포함되어 있지 않더라도). 이는 코드가 바이너리의 코드에 의해 명시적으로 호출되지 않는 경우(예: 코드가 일부 서비스에서 제공하는 일부 콜백을 수신하도록 등록되는 경우) 유용합니다.
copts

문자열 목록입니다. 기본값은 []입니다.

컴파일러에 전달할 추가 플래그입니다. 'Make 변수' 대체 및 Bourne 셸 토큰화가 적용됩니다. 이러한 플래그는 이 타겟에만 적용되며 이 타겟에 종속되거나 이 타겟에 종속되는 타겟에는 적용되지 않습니다.

생성된 Xcode 프로젝트의 경우 copt에서 '-I' 플래그를 사용하여 지정된 디렉터리 경로가 파싱되고 상대 경로인 경우 앞에 '$(WORKSPACE_ROOT)/'가 추가되고 연결된 Xcode 대상의 헤더 검색 경로에 추가됩니다.

defines

문자열 목록. 기본값은 []입니다.

컴파일러에 전달할 추가 -D 플래그입니다. KEY=VALUE 형식 또는 KEY 형식이어야 하며 이 타겟의 컴파일러(copts와 마찬가지로)뿐만 아니라 이 타겟의 모든 objc_ 종속 항목에도 전달됩니다. 'Make 변수' 대체 및 Bourne 셸 토큰화가 적용됩니다.
enable_modules

부울. 기본값은 False입니다.

-fmodules를 통해 clang 모듈 지원을 사용 설정합니다. 이 값을 1로 설정하면 시스템 헤더 및 기타 대상을 @import할 수 있습니다. @import UIKit; @import path_to_package_target;
implementation_deps

라벨 목록. 기본값은 []입니다.

라이브러리 타겟이 종속되는 다른 라이브러리의 목록입니다. deps와 달리 이러한 라이브러리의 헤더 및 포함 경로(및 모든 전이 종속 항목)는 이 라이브러리의 컴파일에만 사용되며 이 라이브러리에 종속되는 라이브러리에는 사용되지 않습니다. implementation_deps로 지정된 라이브러리는 이 라이브러리에 종속된 바이너리 타겟에서 계속 연결됩니다.
includes

문자열 목록입니다. 기본값은 []입니다.

이 타겟 및 모든 종속 타겟에 추가할 #include/#import 검색 경로 목록입니다. 이는 #import/#include 문에 전체 워크스페이스 경로를 지정하지 않는 서드 파티 및 오픈소스 라이브러리를 지원하기 위한 것입니다.

경로는 패키지 디렉터리를 기준으로 해석되며, 실제 클라이언트 루트 외에도 genfile과 bin 루트 (예: blaze-genfiles/pkg/includedirblaze-out/pkg/includedir)가 포함됩니다.

COPTS와 달리 이러한 플래그는 이 규칙과 이 규칙에 종속되는 모든 규칙에 추가됩니다. (참고: 종속되는 규칙이 아닙니다.) 광범위한 영향을 미칠 수 있으므로 매우 주의해야 합니다. 확실하지 않은 경우에는 대신 '-iquote' 플래그를 COPTS에 추가하세요.

linkopts

문자열 목록입니다. 기본값은 []입니다.

링커에 전달할 추가 플래그입니다.
module_map

라벨: 기본값은 None입니다.

이 타겟의 맞춤 Clang 모듈 맵입니다. 맞춤 모듈 맵은 사용하지 않는 것이 좋습니다. 대부분의 사용자는 Bazel에서 생성한 모듈 맵을 사용해야 합니다. 지정하면 Bazel은 이 타겟의 모듈 맵을 생성하지 않고 제공된 모듈 맵을 컴파일러에 전달합니다.
module_name

문자열, 기본값은 ""입니다.

이 타겟의 모듈 이름을 설정합니다. 기본적으로 모듈 이름은 모든 특수 기호가 _로 대체된 대상 경로입니다. 예를 들어 //foo/baz:bar는 foo_baz_bar로 가져올 수 있습니다.
non_arc_srcs

라벨 목록입니다. 기본값은 []입니다.

ARC를 사용하지 않는 라이브러리 타겟을 만들기 위해 처리되는 Objective-C 파일 목록입니다. 이 속성의 파일은 srcs 속성의 파일과 매우 유사하게 취급되지만 ARC를 사용 설정하지 않고 컴파일됩니다.
pch

라벨: 기본값은 None입니다.

컴파일되는 모든 소스 파일 (arc 및 비 arc 모두) 앞에 추가할 헤더 파일입니다. BUILD 파일에서 pch 파일을 사용하지 않는 것이 좋으며 이 경우 지원 중단된 것으로 간주해야 합니다. pch 파일은 실제로 사전 컴파일되지 않으므로 이는 빌드 속도 향상이 아니라 전역 종속 항목입니다. 빌드 효율성 관점에서 보면 필요한 소스에 필요한 항목을 직접 포함하는 것이 좋습니다.
sdk_dylibs

문자열 목록입니다. 기본값은 []입니다.

연결할 SDK .dylib 라이브러리의 이름입니다. 예를 들어 'libz' 또는 'libarchive'가 있습니다. 바이너리의 종속 항목 트리에 C++ 또는 Objective-C++ 소스가 있는 경우 'libc++'가 자동으로 포함됩니다. 바이너리를 연결할 때 해당 바이너리의 전이 종속 항목 그래프에 이름이 지정된 모든 라이브러리가 사용됩니다.
sdk_frameworks

문자열 목록. 기본값은 []입니다.

연결할 SDK 프레임워크의 이름입니다(예: 'AddressBook', 'QuartzCore'). 'UIKit' 및 'Foundation'은 iOS, tvOS, visionOS, watchOS 플랫폼용으로 빌드할 때 항상 포함됩니다. macOS의 경우 항상 'Foundation'만 포함됩니다.

최상위 Apple 바이너리를 연결하면 해당 바이너리의 전이 종속 항목 그래프에 나열된 모든 SDK 프레임워크가 연결됩니다.

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 규칙 인스턴스에서 원격 및 로컬에서 사용 가능한 xcode 버전을 나타내는 데 사용할 수 있습니다. 이렇게 하면 전체적으로 사용 가능한 xcode에서 공식 xcode 버전을 선택할 수 있습니다.

인수

속성
name

이름: 필수사항

이 타겟의 고유한 이름입니다.

default

라벨: 구성 불가; 필수사항

이 플랫폼의 기본 xcode 버전입니다.
versions

라벨 목록입니다. 구성할 수 없음. 기본값은 []입니다.

이 플랫폼에서 사용할 수 있는 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 버전을 선택할 수 있습니다.

인수

속성
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

라벨 목록입니다. 구성할 수 없음. 기본값은 []입니다.

사용할 수 있는 허용된 xcode_version 타겟입니다. 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 규칙을 참고하세요.

인수

속성
name

이름: 필수사항

이 타겟의 고유한 이름입니다.

default_ios_sdk_version

문자열, 구성 불가, 기본값은 ""입니다.

이 버전의 Xcode를 사용할 때 기본적으로 사용되는 iOS SDK 버전입니다. ios_sdk_version 빌드 플래그는 여기에 지정된 값보다 우선 적용됩니다.
default_macos_sdk_version

문자열, 구성 불가, 기본값은 ""

이 버전의 xcode를 사용할 때 기본적으로 사용되는 macOS SDK 버전입니다. macos_sdk_version 빌드 플래그는 여기에 지정된 값보다 우선 적용됩니다.
default_tvos_sdk_version

문자열, 구성 불가, 기본값은 ""입니다.

이 버전의 Xcode를 사용할 때 기본적으로 사용되는 tvos sdk 버전입니다. tvos_sdk_version 빌드 플래그는 여기에 지정된 값보다 우선 적용됩니다.
default_visionos_sdk_version

문자열, 구성 불가, 기본값은 ""입니다.

이 버전의 Xcode를 사용할 때 기본적으로 사용되는 VisionOS SDK 버전입니다. visionos_sdk_version 빌드 플래그는 여기에 지정된 값보다 우선 적용됩니다.
default_watchos_sdk_version

문자열, 구성 불가, 기본값은 ""입니다.

이 버전의 Xcode를 사용할 때 기본적으로 사용되는 watchos sdk 버전입니다. watchos_sdk_version 빌드 플래그는 여기에 지정된 값보다 우선 적용됩니다.
version

문자열, 구성 불가, 필수

Xcode 버전의 공식 버전 번호입니다.