Reglas de Objective-C

Informar un problema Ver fuente

Reglas

• j2objc_library
• objc_import
• objc_library
• available_xcodes
• xcode_config
• xcode_version

j2objc_library

Ver la fuente de la regla

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 archivos fuente de Java a Objective-C, que luego se pueden usar como dependencias de las reglas objc_library y objc_binary. Puedes encontrar información detallada sobre J2ObjC en el sitio de J2ObjC.

Las marcas de transpilación personalizadas de J2ObjC 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 un destino j2objc_library se compilarán usando la configuración de compilación predeterminada, la misma configuración que para las fuentes de 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 a nivel del origen. Si tienes dos objetivos Java diferentes que incluyen los mismos archivos fuente 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 de origen de Java compartidos a un destino común independiente en el que se pueda depender.

Argumentos

Atributos
name	Nombre (obligatorio) Un nombre único para este destino.
deps	Lista de etiquetas; el valor predeterminado es [] Una lista de destinos j2objc_library, java_library, java_import y java_proto_library que contienen archivos Java para transpilar a Objective-C. Se traducirán y compilarán todos los objetivos java_library y java_import a los que se puede llegar de forma transitiva mediante exports, deps y runtime_deps, incluidos los archivos que genera el procesamiento de anotaciones de Java. No se admite el uso de valores code>java_import sin srcjar especificado. La traducción de J2ObjC funciona de manera diferente según el tipo de archivos de origen Java de origen que se incluyen en el cierre transitivo. Por cada archivo fuente .java incluido en srcs de java_library, se generará un archivo fuente .h y .m correspondiente. Para cada archivo jar fuente incluido en srcs de java_library o srcjar de java_import, se generará un archivo fuente .h y .m correspondiente 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 para estos archivos son la ruta relativa raíz de los artefactos originales de Java. Por ejemplo, //some/package/foo.java tiene la ruta de importación some/package/foo.h, y //some/package/bar.srcjar tiene some/package/bar.h. Si las reglas proto_library tienen el cierre transitivo de esta regla, los protos J2ObjC también se generarán, compilarán y vincularán a nivel binario. Para el proto //some/proto/foo.proto, los usuarios pueden hacer referencia al código generado con la ruta de importación some/proto/foo.j2objc.pb.h.
entry_classes	Lista de cadenas; el valor predeterminado es [] Lista de clases de Java a cuyas contrapartes ObjC traducidas hace referencia directamente el código ObjC del usuario. Este atributo es obligatorio si la marca --j2objc_dead_code_removal está activada. Las clases de Java se deben especificar en sus nombres canónicos, como se define en la especificación del lenguaje Java. Cuando se especifica la marca --j2objc_dead_code_removal, la lista de clases de entrada se recopila de forma transitiva y se usa como puntos de entrada para realizar un análisis de código muerto. Las clases no utilizadas se quitarán del paquete de aplicación ObjC final.
jre_deps	Lista de etiquetas; el valor predeterminado es [] Es la lista de bibliotecas de emulación de JRE adicionales que requieren todo el código Java traducido por esta regla j2objc_library. Solo la funcionalidad principal de JRE está vinculada de forma predeterminada.

objc_import

Ver la fuente de la regla

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)

Esta regla encapsula una biblioteca estática ya compilada en forma de un archivo .a. También permite exportar encabezados y recursos mediante los mismos atributos compatibles con objc_library.

Argumentos

Atributos
name	Nombre (obligatorio) Un nombre único para este destino.
deps	Lista de etiquetas; el valor predeterminado es [] Es la lista de objetivos de los que depende este objetivo.
hdrs	Lista de etiquetas; el valor predeterminado es [] La lista de archivos de encabezado C, C++, Objective-C y Objective-C++ publicados por esta biblioteca para que los incluyan las fuentes en reglas dependientes. Estos encabezados describen la interfaz pública de la biblioteca y estarán disponibles para su inclusión mediante fuentes en esta regla o en reglas dependientes. Los encabezados que no deben incluirse por un cliente de esta biblioteca deben enumerarse en el atributo srcs. Estos se compilarán por separado de la fuente si los módulos están habilitados.
alwayslink	Booleano; el valor predeterminado es False Si es 1, cualquier paquete o objeto binario que dependa (directa o indirectamente) de esta biblioteca se vinculará en todos los archivos de objetos para los archivos enumerados en srcs y non_arc_srcs, incluso si algunos no contienen símbolos al que hace referencia el objeto binario. Esto resulta útil si tu código no se llama explícitamente mediante código en el objeto binario, p.ej., si se registra para recibir una devolución de llamada proporcionada por algún servicio.
archives	Lista de etiquetas (obligatoria) La lista de archivos .a que se proporcionan a los destinos de Objective-C que dependen de este destino.
includes	Lista de cadenas; el valor predeterminado es [] Lista de rutas de búsqueda de #include/#import para agregar a este destino y a todos los destinos dependientes. El objetivo de esto es admitir bibliotecas de terceros y de código abierto que no especifican la ruta de acceso completa del lugar de trabajo en sus declaraciones #import/#include. Las rutas de acceso se interpretan en relación con el directorio del paquete, y los archivos genfiles y las raíces binarias (p.ej., blaze-genfiles/pkg/includedir y blaze-out/pkg/includedir) se incluyen además de la raíz de cliente real. A diferencia de COPTS, estas marcas se agregan para esta regla y para cada regla que depende de ella. (Nota: No son las reglas de las que depende). Ten mucho cuidado, ya que esto puede tener efectos de gran alcance. Si tienes dudas, agrega las marcas "-iQuote" a COPTS.
sdk_dylibs	Lista de cadenas; el valor predeterminado es [] Nombres de las bibliotecas .dylib del SDK con las que se vinculará. Por ejemplo, "libz" o "libarchive". "libc++" se incluye automáticamente si el objeto binario tiene fuentes C++ u Objective-C++ en su árbol de dependencias. Cuando se vincula un objeto binario, se usan todas las bibliotecas nombradas en el gráfico de dependencia transitiva de ese objeto binario.
sdk_frameworks	Lista de cadenas; el valor predeterminado es [] Nombres de frameworks de SDK con los que se vinculará (p.ej., "AddressBook", "QuartzCore"). “UIKit” y “Foundation” siempre se incluyen cuando compilas para las plataformas iOS, tvOS, visionOS y watchOS. Para macOS, solo se incluye “Foundation”. Cuando se vincula un objeto binario de Apple de nivel superior, se vinculan todos los frameworks del SDK que se indican en el gráfico de dependencias transitivas de ese objeto binario.
sdk_includes	Lista de cadenas; el valor predeterminado es [] Lista de rutas de búsqueda de #include/#import para agregar a este destino y a todos los destinos dependientes, en la que cada ruta de acceso está relacionada con $(SDKROOT)/usr/include.
textual_hdrs	Lista de etiquetas; el valor predeterminado es [] Lista de archivos C, C++, Objective-C y Objective-C++ que se incluyen como encabezados por archivos de origen en esta regla o por usuarios de esta biblioteca. A diferencia de los HD, estos no se compilarán por separado de las fuentes.
weak_sdk_frameworks	Lista de cadenas; el valor predeterminado es [] Nombres de frameworks del SDK para vincular de forma débil Por ejemplo, "MediaAccessibility". A diferencia de los frameworks de SDK vinculados regularmente, los símbolos de marcos de trabajo con vínculos débiles no causan un error si no están presentes en el tiempo de ejecución.

objc_library

Ver la fuente de la regla

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)

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

Argumentos

Atributos
name	Nombre (obligatorio) Un nombre único para este destino.
deps	Lista de etiquetas; el valor predeterminado es [] Es la lista de segmentaciones que están vinculadas para formar el paquete final.
srcs	Lista de etiquetas; el valor predeterminado es [] La lista de archivos fuente y de encabezado de C, C++, Objective-C y Objective-C++, o archivos fuente de ensamblado (“.s”, “.S” o “.asm”) que se procesan para crear el destino de la biblioteca. Estos son los archivos registrados, además de los archivos generados. Los archivos de origen se compilan en archivos .o con Clang. Cualquier fuente o encabezado puede incluir o importar archivos de encabezado en el atributo srcs de este destino, pero no mediante encabezados en HDR ni otros objetivos que dependan de esta regla. Además, los archivos .o precompilados se pueden proporcionar como srcs. Asegúrate de garantizar la coherencia entre la arquitectura de los archivos .o proporcionados y la de la compilación para evitar errores de vinculador de símbolos.
hdrs	Lista de etiquetas; el valor predeterminado es [] La lista de archivos de encabezado C, C++, Objective-C y Objective-C++ publicados por esta biblioteca para que los incluyan las fuentes en reglas dependientes. Estos encabezados describen la interfaz pública de la biblioteca y estarán disponibles para su inclusión mediante fuentes en esta regla o en reglas dependientes. Los encabezados que no deben incluirse por un cliente de esta biblioteca deben enumerarse en el atributo srcs. Estos se compilarán por separado de la fuente si los módulos están habilitados.
alwayslink	Booleano; el valor predeterminado es False Si es 1, cualquier paquete o objeto binario que dependa (directa o indirectamente) de esta biblioteca se vinculará en todos los archivos de objetos para los archivos enumerados en srcs y non_arc_srcs, incluso si algunos no contienen símbolos al que hace referencia el objeto binario. Esto resulta útil si tu código no se llama explícitamente mediante código en el objeto binario, p.ej., si se registra para recibir una devolución de llamada proporcionada por algún servicio.
copts	Lista de cadenas; el valor predeterminado es [] Marcas adicionales para pasar al compilador. Sujeto a la sustitución "Make variable" y la tokenización de shell Bourne. Estas marcas solo se aplicarán a este destino y no a aquellos de los que depende o a aquellos que dependen de él. Ten en cuenta que, para el proyecto de Xcode generado, las rutas de directorio especificadas con las marcas “-I” en copts se analizan, se les antepone “$(WORKSPACE_ROOT)/” si son rutas relativas y se agregan a las rutas de búsqueda de encabezados del destino de Xcode asociado.
defines	Lista de cadenas; el valor predeterminado es [] Marcas -D adicionales para pasar al compilador Deben tener el formato KEY=VALUE o simplemente KEY, y se pasan no solo al compilador para este destino (como sucede con copts), sino también a todos los objc_ dependencias de este destino. Sujeto a la sustitución "Make variable" y la tokenización de shell Bourne.
enable_modules	Booleano; el valor predeterminado es False Habilita la compatibilidad con el módulo de Clang (a través de -fmodules). Configurarlo en 1 te permitirá usar @import encabezados del sistema y otros destinos: @import UIKit; @import path_to_package_target;
implementation_deps	Lista de etiquetas; el valor predeterminado es [] Es la lista de otras bibliotecas de las que depende el destino de la biblioteca. A diferencia de deps, las rutas de inclusión y los encabezados de estas bibliotecas (y todas sus dependencias transitivas) solo se utilizan para la compilación de esta biblioteca, y no las bibliotecas que dependen de ella. Las bibliotecas especificadas con implementation_deps siguen vinculadas en objetivos binarios que dependen de esta biblioteca.
includes	Lista de cadenas; el valor predeterminado es [] Lista de rutas de búsqueda de #include/#import para agregar a este destino y a todos los destinos dependientes. El objetivo de esto es admitir bibliotecas de terceros y de código abierto que no especifican la ruta de acceso completa del lugar de trabajo en sus declaraciones #import/#include. Las rutas de acceso se interpretan en relación con el directorio del paquete, y los archivos genfiles y las raíces binarias (p.ej., blaze-genfiles/pkg/includedir y blaze-out/pkg/includedir) se incluyen además de la raíz de cliente real. A diferencia de COPTS, estas marcas se agregan para esta regla y para cada regla que depende de ella. (Nota: No son las reglas de las que depende). Ten mucho cuidado, ya que esto puede tener efectos de gran alcance. Si tienes dudas, agrega las marcas "-iQuote" a COPTS.
linkopts	Lista de cadenas; el valor predeterminado es [] Marcas adicionales para pasar al vinculador.
module_map	Label; el valor predeterminado es None Un mapa personalizado de módulos de Clang para este destino No se recomienda el uso de un mapa de módulos personalizado. La mayoría de 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 mapa del módulo proporcionado al compilador.
module_name	String; el valor predeterminado es "" Establece el nombre de módulo para este destino. De forma predeterminada, el nombre del módulo es la ruta de destino en la que todos los símbolos especiales se reemplazan por _; p.ej., //foo/baz:bar se puede importar como foo_baz_bar.
non_arc_srcs	Lista de etiquetas; el valor predeterminado es [] La lista de archivos Objective-C que se procesan para crear el destino de la biblioteca que NO usan ARC. Los archivos en este atributo se tratan de manera muy similar a los del atributo srcs, pero se compilan sin ARC habilitado.
pch	Label; el valor predeterminado es None Archivo de encabezado que se debe anteponer a cada archivo de origen que se compila (tanto en arco como que no sean de arco). No se recomienda activamente el uso de archivos pch en los archivos BUILD, por lo que debe considerarse obsoleto. Como los archivos pch en realidad no se compilan previamente, no se trata de una mejora de la velocidad de compilación, sino que es solo una dependencia global. Desde el punto de vista de la eficiencia de compilación, en realidad eres mejor incluir lo que necesitas directamente en las fuentes donde lo necesitas.
sdk_dylibs	Lista de cadenas; el valor predeterminado es [] Nombres de las bibliotecas .dylib del SDK con las que se vinculará. Por ejemplo, "libz" o "libarchive". "libc++" se incluye automáticamente si el objeto binario tiene fuentes C++ u Objective-C++ en su árbol de dependencias. Cuando se vincula un objeto binario, se usan todas las bibliotecas nombradas en el gráfico de dependencia transitiva de ese objeto binario.
sdk_frameworks	Lista de cadenas; el valor predeterminado es [] Nombres de frameworks de SDK con los que se vinculará (p.ej., "AddressBook", "QuartzCore"). “UIKit” y “Foundation” siempre se incluyen cuando compilas para las plataformas iOS, tvOS, visionOS y watchOS. Para macOS, solo se incluye “Foundation”. Cuando se vincula un objeto binario de Apple de nivel superior, se vinculan todos los frameworks del SDK que se indican en el gráfico de dependencias transitivas de ese objeto binario.
sdk_includes	Lista de cadenas; el valor predeterminado es [] Lista de rutas de búsqueda de #include/#import para agregar a este destino y a todos los destinos dependientes, en la que cada ruta de acceso está relacionada con $(SDKROOT)/usr/include.
textual_hdrs	Lista de etiquetas; el valor predeterminado es [] Lista de archivos C, C++, Objective-C y Objective-C++ que se incluyen como encabezados por archivos de origen en esta regla o por usuarios de esta biblioteca. A diferencia de los HD, estos no se compilarán por separado de las fuentes.
weak_sdk_frameworks	Lista de cadenas; el valor predeterminado es [] Nombres de frameworks del SDK para vincular de forma débil Por ejemplo, "MediaAccessibility". A diferencia de los frameworks de SDK vinculados regularmente, los símbolos de marcos de trabajo con vínculos débiles no causan un error si no están presentes en el tiempo de ejecución.

available_xcodes

Ver la fuente de la regla

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

Una instancia de regla xcode_config puede depender de dos objetivos de esta regla para indicar las versiones de Xcode disponibles de forma remota y local. Esto permite seleccionar una versión oficial de Xcode entre los Xcode disponibles en conjunto.

Argumentos

Atributos
name	Nombre (obligatorio) Un nombre único para este destino.
default	Etiqueta; no configurable; obligatorio Es la versión de Xcode predeterminada para esta plataforma.
versions	Lista de etiquetas; no configurable; el valor predeterminado es [] Las versiones de Xcode disponibles en esta plataforma.

xcode_config

Ver la fuente de la regla

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

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

Argumentos

Atributos
name	Nombre (obligatorio) Un nombre único para este destino.
default	Etiqueta; no configurable; el valor predeterminado es None Es la versión oficial predeterminada de Xcode. Se usará la versión especificada por el destino xcode_version proporcionado si no se especifica ninguna marca de compilación xcode_version. Es obligatorio si se configura algún versions. Es posible que esto no esté configurado si se configuran remote_versions o local_versions.
local_versions	Etiqueta; no configurable; el valor predeterminado es None Los destinos de xcode_version que están disponibles de forma local Estos se usan junto con local_versions para seleccionar una versión disponible de forma mutua. Es posible que esto no se establezca si se configura versions.
remote_versions	Etiqueta; no configurable; el valor predeterminado es None Los destinos de xcode_version que están disponibles de forma remota Estos se usan junto con remote_versions para seleccionar una versión disponible de forma mutua. Es posible que esto no se establezca si se configura versions.
versions	Lista de etiquetas; no configurable; el valor predeterminado es [] Se aceptaron xcode_version objetivos que pueden usarse. Si el valor de la marca de compilación xcode_version coincide con uno de los alias o el número de versión de cualquiera de los destinos xcode_version especificados, se usará el objetivo coincidente. Es posible que esto no esté configurado si se configuran remote_versions o local_versions.

xcode_version

Ver la fuente de la regla

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)

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

Argumentos

Atributos
name	Nombre (obligatorio) Un nombre único para este destino.
default_ios_sdk_version	String; no configurable; el valor predeterminado es "" Es la versión del SDK de iOS que se usa de forma predeterminada cuando se utiliza esta versión de Xcode. La marca de compilación ios_sdk_version anulará el valor especificado aquí.
default_macos_sdk_version	String; no configurable; el valor predeterminado es "" La versión del SDK de macOS que se usa de forma predeterminada cuando se utiliza esta versión de Xcode. La marca de compilación macos_sdk_version anulará el valor especificado aquí.
default_tvos_sdk_version	String; no configurable; el valor predeterminado es "" La versión del SDK de tvos que se usa de forma predeterminada cuando se usa esta versión de Xcode. La marca de compilación tvos_sdk_version anulará el valor especificado aquí.
default_visionos_sdk_version	String; no configurable; el valor predeterminado es "" La versión del SDK de visiones que se usa de forma predeterminada cuando se utiliza esta versión de Xcode. La marca de compilación visionos_sdk_version anulará el valor especificado aquí.
default_watchos_sdk_version	String; no configurable; el valor predeterminado es "" La versión del SDK de watchos que se usa de forma predeterminada cuando se utiliza esta versión de Xcode. La marca de compilación watchos_sdk_version anulará el valor especificado aquí.
version	Cadena; no configurable; obligatoria Es el número de versión oficial de una versión de Xcode.