Reglas de Objective-C

Reglas

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)

Esta regla usa J2ObjC para traducir el código fuente de Java en Objective-C, que luego se pueden usar como dependencias de objc_library y objc_binary las reglas de firewall. Puedes encontrar información detallada acerca de J2ObjC en la Sitio de J2ObjC

Las marcas de transpilación J2ObjC personalizadas se pueden especificar con la marca de compilación --j2objc_translation_flags en la línea de comandos.

Ten en cuenta que los archivos traducidos incluidos en el destino j2objc_library se compilar usando la configuración de compilación predeterminada, que es la misma que la de las fuentes Una regla objc_library sin opciones de compilación especificadas en los atributos.

Además, se anula la duplicación del código generado a nivel del destino, no del fuente. Si tienes dos diferentes destinos de Java que incluyen los mismos archivos de origen de Java, es posible que veas un error de símbolo duplicado en el momento de la vinculación. La forma correcta de resolver este problema es mover los archivos fuente de Java compartidos a un objetivo común separado del que se puede confiar.

Argumentos

Atributos
`name`	`Name; required` Un nombre único para este destino.
`deps`	`List of labels; optional` Una lista de `j2objc_library`, `java_library` Destinos `java_import` y `java_proto_library` que contienen Archivos Java que se transpilarán a Objective-C. Todos los objetivos de `java_library` y `java_import` que se pueden alcanzar de forma transitiva a través de `exports`, `deps` y `runtime_deps` se traducirán y compilarán. Por el momento, no se admiten archivos generados por Java procesamiento de anotaciones o destinos de `java_import` sin `srcjar` especificada. La traducción de J2ObjC funciona de manera diferente según el tipo de fuente de origen de Java. archivos incluidos en el cierre transitivo. Por cada archivo fuente .java incluido en `srcs` de `java_library`, un archivo fuente .h y .m correspondiente de configuración. Para cada archivo jar de origen incluido en `srcs` de `java_library` o `srcjar` de `java_import`, un el archivo fuente .h y .m correspondiente se generará con todo el código para ese jar. Los usuarios pueden importar los archivos de encabezado generados por J2ObjC en su código. Las rutas de importación de Estos archivos son la ruta de acceso relativa de raíz de los artefactos originales de Java. Por ejemplo: La ruta de importación de `//some/package/foo.java` es `some/package/foo.h` y `//some/package/bar.srcjar` tiene `some/package/bar.h` Si las reglas proto_library están en el cierre transitivo de esta regla, los proto J2ObjC también generarse, compilarse y vincularse a nivel binario. Para proto `//some/proto/foo.proto`, los usuarios pueden hacer referencia al código generado con la función de importación `some/proto/foo.j2objc.pb.h` de la ruta de acceso.
`entry_classes`	`List of strings; optional` La lista de clases de Java a cuyos equivalentes traducidos de ObjC se hará referencia directamente por código ObjC del usuario. Este atributo es obligatorio si la marca `--j2objc_dead_code_removal` está activada. Las clases Java deben especificarse en sus nombres canónicos, como se define en el Java Especificación de lenguaje. Cuando se especifica la marca `--j2objc_dead_code_removal`, se muestra la lista de clases de entrada se recopilarán de forma transitiva y se usarán como puntos de entrada para realizar un análisis de código no muerto. Luego, las clases no usadas se quitarán del paquete de aplicación ObjC final.
`jre_deps`	`List of labels; optional` Lista de bibliotecas de emulación de JRE adicionales que requiere todo el código Java traducido por este Regla `j2objc_library`. Solo la funcionalidad principal de JRE está vinculada de forma predeterminada.

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)

Esta regla encapsula una biblioteca estática ya compilada en forma de un .a. También permite exportar encabezados y recursos usando la misma atributos admitidos por objc_library.

Argumentos

Atributos
`name`	`Name; required` Un nombre único para este destino.
`hdrs`	`List of labels; optional` La lista de archivos de encabezado C, C++, Objective-C y Objective-C++ publicados de esta biblioteca para que se incluyan en las fuentes en las reglas dependientes. Estos encabezados describen la interfaz pública para la biblioteca y serán se pusieron a disposición de las fuentes en esta regla o en fuentes las reglas de firewall. Encabezados que no deben ser incluidos por un cliente de esta biblioteca se debe indicar en el atributo srcs en su lugar. Se compilarán por separado de la fuente si los módulos están habilitados.
`alwayslink`	`Boolean; optional; default is False` Si es 1, es cualquier paquete o objeto binario que depende (directa o indirectamente) de este biblioteca vinculará todos los archivos de objeto de los archivos enumerados en `srcs` y `non_arc_srcs`, incluso si algunos no contienen a los que hace referencia el objeto binario. Esto es útil si no se llama explícitamente a tu código en el objeto binario, p.ej., si tu código se registra para recibir alguna devolución de llamada proporcionados por algún servicio.
`archives`	`List of labels; required` La lista de archivos `.a` proporcionados a los objetivos de Objective-C que depender de este objetivo.
`includes`	`List of strings; optional` Lista de `#include/#import` rutas de búsqueda para agregar a este destino y todos los objetivos dependientes. Esto es para admitir bibliotecas de terceros y de código abierto que no especificar la ruta del lugar de trabajo completa en la Declaraciones `#import/#include`. Las rutas de acceso se interpretan en relación con el directorio del paquete. Archivos genfile y raíces bin (p.ej., `blaze-genfiles/pkg/includedir` y `blaze-out/pkg/includedir`) se incluyen además del la raíz del cliente real. A diferencia de COPTS, estas marcas se agregan a esta regla. y cada regla que depende de él. (Nota: No depende de las reglas de las que depende). Sé esto puede tener efectos de largo alcance. Si tienes dudas, agrega “-iquote” a COPTS.
`sdk_dylibs`	`List of strings; optional` Nombres de las bibliotecas .dylib del SDK con las que se vincularán. Por ejemplo, "libz" o “libarchive”. "libc++" se incluye automáticamente si el objeto binario tiene valores de C++ o Fuentes de Objective-C++ en su árbol de dependencias. Cuando vinculas un objeto binario, todas las bibliotecas nombradas en el gráfico de dependencia transitiva del objeto binario que se usan.
`sdk_frameworks`	`List of strings; optional` Nombres de los frameworks del SDK con los que se vinculará (p.ej., "AddressBook" o "QuartzCore"). “UIKit” y “Base” siempre se incluyen cuando se compila para plataformas de iOS, tvOS y watchOS. Para macOS, solo “Foundation” siempre está incluida. Cuando se vincula un objeto binario de Apple de nivel superior, se enumeran todos los frameworks del SDK que se incluyen en el objeto binario de ese objeto el gráfico de dependencias transitivos están vinculados.
`sdk_includes`	`List of strings; optional` Lista de `#include/#import` rutas de búsqueda para agregar a este destino y todos los destinos dependientes, en los que cada ruta es relativa `$(SDKROOT)/usr/include`
`textual_hdrs`	`List of labels; optional` La lista de archivos C, C++, Objective-C y Objective-C++ que se incluidos como encabezados por los archivos fuente en esta regla o por sus usuarios biblioteca. A diferencia de los HDR, estos no se compilarán por separado del fuentes de datos.
`weak_sdk_frameworks`	`List of strings; optional` Nombres de frameworks del SDK con los que se vinculará de manera débil. Por ejemplo: "MediaAccessibility". A diferencia de los frameworks de SDK vinculados habitualmente, los símbolos de frameworks con vínculos débiles no generan un error si no están presentes en el tiempo de ejecución.

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)

Esta regla produce una biblioteca estática a partir de los archivos fuente de Objective-C proporcionados.

Argumentos

Atributos
`name`	`Name; required` Un nombre único para este destino.
`deps`	`List of labels; optional` Es la lista de objetivos que están vinculados para formar el paquete final.
`srcs`	`List of labels; optional` La lista de fuentes y encabezados de C, C++, Objective-C y Objective-C++ o archivos de origen de ensamblado (`.s`, `.S` o `.asm`), que se procesan para crear el destino de la biblioteca. Estos son los archivos registrados, más los archivos generados. Los archivos fuente se compilan en archivos .o con Clang. Archivos de encabezado cualquier fuente o encabezado del atributo srcs puede incluir o importar de este destino, pero no por los encabezados en hdrs ni por los destinos que dependan de esta regla. Además, los archivos .o precompilados se pueden proporcionar como srcs. Ten cuidado de garantizar la coherencia en la arquitectura de los archivos .o proporcionados y en la de la para evitar errores del vinculador de símbolos.
`hdrs`	`List of labels; optional` La lista de archivos de encabezado C, C++, Objective-C y Objective-C++ publicados de esta biblioteca para que se incluyan en las fuentes en las reglas dependientes. Estos encabezados describen la interfaz pública para la biblioteca y serán se pusieron a disposición de las fuentes en esta regla o en fuentes las reglas de firewall. Encabezados que no deben ser incluidos por un cliente de esta biblioteca se debe indicar en el atributo srcs en su lugar. Se compilarán por separado de la fuente si los módulos están habilitados.
`alwayslink`	`Boolean; optional; default is False` Si es 1, es cualquier paquete o objeto binario que depende (directa o indirectamente) de este biblioteca vinculará todos los archivos de objeto de los archivos enumerados en `srcs` y `non_arc_srcs`, incluso si algunos no contienen a los que hace referencia el objeto binario. Esto es útil si no se llama explícitamente a tu código en el objeto binario, p.ej., si tu código se registra para recibir alguna devolución de llamada proporcionados por algún servicio.
`copts`	`List of strings; optional` Marcas adicionales para pasar al compilador. Con la sustitución "Make variable" y Asignación de token de shell de Bourne. Estas marcas solo se aplicarán a este destino, y no a aquellas en las que depende o depende de él. Ten en cuenta que, en el proyecto de Xcode generado, las rutas de acceso a directorios especificadas con “-I” marcas en Los archivos copts se analizan y se anteponen con "$(WORKSPACE_ROOT)/" si son rutas relativas a las rutas de búsqueda de encabezados para el destino de Xcode asociado.
`defines`	`List of strings; optional` Marcas `-D` adicionales para pasar al compilador. Deben estar en el formulario `KEY=VALUE` o simplemente `KEY`, y son se pasa no solo al compilador para este destino (como `copts` sí), sino también a todos los `objc_` dependientes de este objetivo. Con la sustitución "Make variable" y Asignación de token de shell de Bourne.
`enable_modules`	`Boolean; optional; default is False` Habilita la compatibilidad con el módulo Clang (a través de -fmodules). Si lo estableces en 1, podrás usar @import para los encabezados del sistema y otros objetivos: @import UIKit; @import path_to_package_target;
`includes`	`List of strings; optional` Lista de `#include/#import` rutas de búsqueda para agregar a este destino y todos los objetivos dependientes. Esto es para admitir bibliotecas de terceros y de código abierto que no especificar la ruta del lugar de trabajo completa en la Declaraciones `#import/#include`. Las rutas de acceso se interpretan en relación con el directorio del paquete. Archivos genfile y raíces bin (p.ej., `blaze-genfiles/pkg/includedir` y `blaze-out/pkg/includedir`) se incluyen además del la raíz del cliente real. A diferencia de COPTS, estas marcas se agregan a esta regla. y cada regla que depende de él. (Nota: No depende de las reglas de las que depende). Sé esto puede tener efectos de largo alcance. Si tienes dudas, agrega “-iquote” a COPTS.
`linkopts`	`List of strings; optional` Marcas adicionales para pasar al vinculador.
`module_map`	`Label; optional` Un mapa de módulos Clang personalizado para este destino. No se recomienda el uso de un mapa de módulos personalizado. Más probable los usuarios deben usar mapas de módulos generados por Bazel. Si se especifica, Bazel no generará un mapa de módulos para este destino, pero pasará el de módulos proporcionados al compilador.
`module_name`	`String; optional` Establece el nombre del módulo para este destino. De forma predeterminada, el nombre del módulo es la ruta de destino, con todos los símbolos especiales reemplazados por _; p.ej., //foo/baz:bar se puede importar como foo_baz_bar.
`non_arc_srcs`	`List of labels; optional` La lista de archivos de Objective-C que se procesan para crear la objetivo de la biblioteca que NO usan ARC. Los archivos de este atributo se tratan de manera muy similar a los de la srcs, pero se compilan sin ARC habilitado.
`pch`	`Label; optional` Archivo de encabezado que se antepondrá a cada archivo de origen que se compile (tanto y sin arco). No se recomienda activamente el uso de archivos pch en los archivos BUILD, y esto debería ser así. que se considera obsoleto. Como los archivos pch no están precompilados, esto no es una mejora en la velocidad de compilación que, en cambio, es solo una dependencia global. De una compilación punto de vista de la eficiencia significa que, en realidad, se incluye mejor lo que necesita directamente de tus fuentes cuando lo necesites.
`runtime_deps`	`List of labels; optional` La lista de objetivos del framework que se cargan con retraso en el entorno de ejecución. Se incluyen en el paquete de aplicación, pero sin vincular en el tiempo de compilación.
`sdk_dylibs`	`List of strings; optional` Nombres de las bibliotecas .dylib del SDK con las que se vincularán. Por ejemplo, "libz" o “libarchive”. "libc++" se incluye automáticamente si el objeto binario tiene valores de C++ o Fuentes de Objective-C++ en su árbol de dependencias. Cuando vinculas un objeto binario, todas las bibliotecas nombradas en el gráfico de dependencia transitiva del objeto binario que se usan.
`sdk_frameworks`	`List of strings; optional` Nombres de los frameworks del SDK con los que se vinculará (p.ej., "AddressBook" o "QuartzCore"). “UIKit” y “Base” siempre se incluyen cuando se compila para plataformas de iOS, tvOS y watchOS. Para macOS, solo “Foundation” siempre está incluida. Cuando se vincula un objeto binario de Apple de nivel superior, se enumeran todos los frameworks del SDK que se incluyen en el objeto binario de ese objeto el gráfico de dependencias transitivos están vinculados.
`sdk_includes`	`List of strings; optional` Lista de `#include/#import` rutas de búsqueda para agregar a este destino y todos los destinos dependientes, en los que cada ruta es relativa `$(SDKROOT)/usr/include`
`textual_hdrs`	`List of labels; optional` La lista de archivos C, C++, Objective-C y Objective-C++ que se incluidos como encabezados por los archivos fuente en esta regla o por sus usuarios biblioteca. A diferencia de los HDR, estos no se compilarán por separado del fuentes de datos.
`weak_sdk_frameworks`	`List of strings; optional` Nombres de frameworks del SDK con los que se vinculará de manera débil. Por ejemplo: "MediaAccessibility". A diferencia de los frameworks de SDK vinculados habitualmente, los símbolos de frameworks con vínculos débiles no generan un error si no están presentes en el tiempo de ejecución.

available_xcodes

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

Una instancia de regla xcode_config puede depender de dos destinos de esta regla para indicar las versiones de Xcode disponibles de forma remota y local. Esto permite seleccionar una versión oficial de uno de los códigos disponibles colectivamente.

Argumentos

Atributos

name

Name; required

Un nombre único para este destino.

default

Label; required; nonconfigurable

Es la versión de Xcode predeterminada para esta plataforma.

versions

List of labels; optional; nonconfigurable

Son las versiones de Xcode que están disponibles en esta plataforma.

xcode_config

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

La compilación --xcode_version_config puede hacer referencia a un solo destino de esta regla. marca para traducir la marca --xcode_version a una versión oficial aceptada de Xcode. Esto permite seleccionar una versión oficial de Xcode entre varios alias registrados.

Argumentos

Atributos
`name`	`Name; required` Un nombre único para este destino.
`default`	`Label; optional; nonconfigurable` La versión oficial predeterminada de Xcode que se usará. Se usará la versión que especifica el objetivo `xcode_version` proporcionado en los siguientes casos: no se especificó la marca de compilación `xcode_version`. Esto es obligatorio si existe `versions`. Es posible que no se establezca si `remote_versions` o Se estableció `local_versions`.
`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.` aceptado(s)

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)

Representa una única versión oficial de Xcode con alias aceptables para esa versión. Consulta la regla xcode_config.

Argumentos

Atributos
`name`	`Name; required` Un nombre único para este destino.
`default_ios_sdk_version`	`String; optional; nonconfigurable` Es la versión del SDK de iOS que se usa de forma predeterminada cuando se usa esta versión de Xcode. La marca de compilación `ios_sdk_version` anulará el valor especificado aquí.
`default_macos_sdk_version`	`String; optional; nonconfigurable` La versión del SDK de macOS que se usa de forma predeterminada cuando se usa esta versión de Xcode. La marca de compilación `macos_sdk_version` anulará el valor especificado aquí.
`default_tvos_sdk_version`	`String; optional; nonconfigurable` Es la versión del SDK de tvos que se usa de forma predeterminada cuando se utiliza esta versión de Xcode. La marca de compilación `tvos_sdk_version` anulará el valor especificado aquí.
`default_watchos_sdk_version`	`String; optional; nonconfigurable` La versión del SDK de watchos que se usa de forma predeterminada cuando se usa esta versión de Xcode. La marca de compilación `watchos_sdk_version` anulará el valor especificado aquí.
`version`	`String; required; nonconfigurable` Es el número de versión oficial de una versión de Xcode.