Objective-C 규칙

규칙

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로 변환한 다음 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_library` 및 `java_import` 타겟은 자바 주석 처리에서 생성된 파일을 포함하여 변환 및 컴파일됩니다. 지정된 `srcjar`가 없는 code>java_import 타겟은 지원되지 않습니다. J2ObjC 변환은 전이적 클로저에 포함된 소스 자바 소스 파일의 유형에 따라 다르게 작동합니다. `java_library`의 `srcs`에 포함된 각 .java 소스 파일의 경우 해당하는 .h 및 .m 소스 파일이 생성됩니다. `java_library`의 `srcs` 또는 `java_import`의 `srcjar`에 포함된 각 소스 jar의 경우 해당 .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도 바이너리 수준에서 생성, 컴파일 및 링크됩니다. 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 속성에 나열해야 합니다. 모듈이 사용 설정된 경우 소스와 별도로 컴파일됩니다.
`alwayslink`	부울. 기본값은 `False`입니다. 1이면 이 라이브러리에 직접 또는 간접적으로 종속되는 모든 번들 또는 바이너리는 `srcs` 및 `non_arc_srcs`에 나열된 파일의 모든 객체 파일을 링크합니다(일부 파일에 바이너리에서 참조하는 기호가 포함되어 있지 않더라도). 이는 코드가 바이너리의 코드에 의해 명시적으로 호출되지 않는 경우(예: 코드가 일부 서비스에서 제공하는 일부 콜백을 수신하도록 등록되는 경우) 유용합니다.
`archives`	라벨 목록, 필수 이 타겟에 종속된 Objective-C 타겟에 제공된 `.a` 파일 목록입니다.
`includes`	문자열 목록. 기본값은 `[]`입니다. 이 타겟과 종속된 모든 타겟에 추가할 `#include/#import` 검색 경로의 목록입니다. 이는 `#import/#include` 문에 전체 작업공간 경로를 지정하지 않는 서드 파티 및 오픈소스 라이브러리를 지원하기 위한 것입니다. 경로는 패키지 디렉터리에 대해 상대적으로 해석되며 실제 클라이언트 루트 외에도 genfiles 및 bin 루트(예: `blaze-genfiles/pkg/includedir` 및 `blaze-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 속성에 나열해야 합니다. 모듈이 사용 설정된 경우 소스와 별도로 컴파일됩니다.
`alwayslink`	부울. 기본값은 `False`입니다. 1이면 이 라이브러리에 직접 또는 간접적으로 종속되는 모든 번들 또는 바이너리는 `srcs` 및 `non_arc_srcs`에 나열된 파일의 모든 객체 파일을 링크합니다(일부 파일에 바이너리에서 참조하는 기호가 포함되어 있지 않더라도). 이는 코드가 바이너리의 코드에 의해 명시적으로 호출되지 않는 경우(예: 코드가 일부 서비스에서 제공하는 일부 콜백을 수신하도록 등록되는 경우) 유용합니다.
`copts`	문자열 목록. 기본값은 `[]`입니다. 컴파일러에 전달할 추가 플래그입니다. 'Makevariable' 대체 및 Bourne 셸 토큰화가 적용됩니다. 이러한 플래그는 이 타겟에만 적용되며 이 타겟에 종속되거나 이 타겟에 종속되는 타겟에는 적용되지 않습니다. 생성된 Xcode 프로젝트의 경우 copt에서 '-I' 플래그를 사용하여 지정된 디렉터리 경로가 파싱되고 상대 경로인 경우 앞에 '$(WORKSPACE_ROOT)/'가 추가되고 연결된 Xcode 대상의 헤더 검색 경로에 추가됩니다.
`defines`	문자열 목록입니다. 기본값은 `[]`입니다. 컴파일러에 전달할 추가 `-D` 플래그 `KEY=VALUE` 형식 또는 `KEY` 형식이어야 하며 이 타겟의 컴파일러(`copts`와 마찬가지로)뿐만 아니라 이 타겟의 모든 `objc_` 종속 항목에도 전달됩니다. 'Makevariable' 대체 및 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/includedir` 및 `blaze-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를 사용할 때 기본적으로 사용되는 macosx 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 버전의 공식 버전 번호입니다.