Regras do Objective-C

7.3 · 7.2 · 7.1 · 7.0 · 6.5

Regras

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)

Essa regra usa J2ObjC para traduzir arquivos de origem Java em Objective-C, que podem ser usados como dependências das regras objc_library e objc_binary. Veja informações detalhadas sobre o próprio J2ObjC no site do J2ObjC.

As flags personalizadas de transpilação J2ObjC podem ser especificadas usando a flag de build --j2objc_translation_flags na linha de comando.

Os arquivos traduzidos incluídos em um destino j2objc_library serão compilados usando a configuração de compilação padrão, a mesma configuração usada para as origens de uma regra objc_library sem opções de compilação especificadas nos atributos.

Além disso, o código gerado é desduplicado no nível de destino, não no nível de origem. Se você tiver dois alvos Java diferentes que incluem os mesmos arquivos de origem Java, poderá aparecer um erro de símbolo duplicado no momento da vinculação. A maneira correta de resolver esse problema é mover os arquivos de origem Java compartilhados para um destino comum separado, que pode ser dependente.

Argumentos

Atributos
`name`	Nome: obrigatório Um nome exclusivo para essa segmentação.
`deps`	Lista de rótulos; o padrão é `[]` Uma lista de destinos `j2objc_library`, `java_library`, `java_import` e `java_proto_library` que contêm arquivos Java a serem transpilados para Objective-C. Todos os destinos `java_library` e `java_import` que podem ser alcançados de forma transitiva por `exports`, `deps` e `runtime_deps` serão traduzidos e compilados, incluindo arquivos gerados pelo processamento de anotações Java. Não há suporte para destinos code>java_import sem `srcjar` especificado. A tradução J2ObjC funciona de maneira diferente, dependendo do tipo de arquivos de origem Java incluídos na união transitiva. Para cada arquivo de origem .java incluído em `srcs` de `java_library`, um arquivo de origem .h e .m correspondente será gerado. Para cada jar de origem incluído em `srcs` de `java_library` ou `srcjar` de `java_import`, um arquivo de origem .h e .m correspondente será gerado com todo o código para esse jar. Os usuários podem importar os arquivos de cabeçalho gerados pelo J2ObjC no código. Os caminhos de importação desses arquivos são o caminho relativo à raiz dos artefatos originais do Java. Por exemplo, `//some/package/foo.java` tem um caminho de importação de `some/package/foo.h` e `//some/package/bar.srcjar` tem `some/package/bar.h` Se as regras de proto_library estiverem no fechamento transitivo desta regra, os protos J2ObjC também serão gerados, compilados e vinculados no nível binário. Para `//some/proto/foo.proto` proto, os usuários podem referenciar o código gerado usando o caminho de importação `some/proto/foo.j2objc.pb.h`.
`entry_classes`	Lista de strings. O padrão é `[]`. A lista de classes Java com as contrapartes traduzidas do ObjC que serão referenciadas diretamente pelo código do usuário do ObjC. Esse atributo será obrigatório se a sinalização `--j2objc_dead_code_removal` estiver ativada. As classes Java precisam ser especificadas nos nomes canônicos, conforme definido pela especificação da linguagem Java. Quando a flag `--j2objc_dead_code_removal` é especificada, a lista de classes de entrada é coletada transitivamente e usada como pontos de entrada para realizar a análise de código morto. As classes não utilizadas serão removidas do pacote final do app ObjC.
`jre_deps`	Lista de rótulos. O padrão é `[]`. Lista de outras bibliotecas de emulação de JRE exigidas por todo o código Java traduzido por esta regra `j2objc_library`. Somente a funcionalidade principal do JRE é vinculada por padrão.

objc_import

Acessar a origem da regra

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)

Essa regra encapsula uma biblioteca estática já compilada na forma de um arquivo .a. Também permite exportar cabeçalhos e recursos usando os mesmos atributos aceitos por objc_library.

Argumentos

Atributos
`name`	Nome: obrigatório Um nome exclusivo para essa segmentação.
`deps`	Lista de rótulos; o padrão é `[]` Lista de destinos de que esse destino depende.
`hdrs`	Lista de rótulos. O padrão é `[]`. A lista de arquivos de cabeçalho C, C++, Objective-C e Objective-C++ publicados por essa biblioteca para serem incluídos por fontes em regras dependentes. Esses cabeçalhos descrevem a interface pública da biblioteca e serão disponibilizados para inclusão por fontes nesta regra ou em regras dependentes. Os cabeçalhos que não precisam ser incluídos por um cliente dessa biblioteca precisam ser listados no atributo srcs. Eles serão compilados separadamente da origem se os módulos estiverem ativados.
`alwayslink`	Booleano; o padrão é `False` Se for 1, qualquer pacote ou binário que dependa (direta ou indiretamente) dessa biblioteca será vinculado a todos os arquivos de objeto dos arquivos listados em `srcs` e `non_arc_srcs`, mesmo que alguns não contenham símbolos referenciados pelo binário. Isso é útil se seu código não for chamado explicitamente por código no binário, por exemplo, se seu código for registrado para receber algum callback fornecido por algum serviço.
`archives`	Lista de rótulos; obrigatório A lista de arquivos `.a` fornecidos para destinos Objective-C que dependem desse destino.
`includes`	Lista de strings. O padrão é `[]`. Lista de caminhos de pesquisa `#include/#import` a serem adicionados a essa segmentação e a todas as segmentações dependentes. Isso é para oferecer suporte a bibliotecas de terceiros e de código aberto que não especificam o caminho completo do espaço de trabalho nas instruções `#import/#include`. Os caminhos são interpretados em relação ao diretório do pacote, e os arquivos gen e bin raiz (por exemplo, `blaze-genfiles/pkg/includedir` e `blaze-out/pkg/includedir`) são incluídos além da raiz do cliente real. Ao contrário de COPTS, essas sinalizações são adicionadas a essa regra e a todas as regras que dependem dela. Observação: não são as regras das quais ele depende. Tenha muito cuidado, porque isso pode ter efeitos de longo alcance. Em caso de dúvida, adicione flags "-iquote" a COPTS.
`sdk_dylibs`	Lista de strings. O padrão é `[]`. Nomes das bibliotecas .dylib do SDK para vincular. Por exemplo, "libz" ou "libarchive". "libc++" é incluído automaticamente se o binário tiver origens C++ ou Objective-C++ na árvore de dependências. Ao vincular um binário, todas as bibliotecas nomeadas no gráfico de dependências transitivas desse binário são usadas.
`sdk_frameworks`	Lista de strings. O padrão é `[]`. Nomes de frameworks de SDK para vincular (por exemplo, "AddressBook", "QuartzCore"). "UIKit" e "Foundation" são sempre incluídos ao criar para as plataformas iOS, tvOS, visionOS e watchOS. No macOS, apenas "Foundation" é sempre incluído. Ao vincular um binário de nível superior da Apple, todos os frameworks do SDK listados no gráfico de dependência transitiva do binário são vinculados.
`sdk_includes`	Lista de strings. O padrão é `[]`. Lista de caminhos de pesquisa de `#include/#import` a serem adicionados a esse destino e a todos os destinos dependentes, em que cada caminho é relativo a `$(SDKROOT)/usr/include`.
`textual_hdrs`	Lista de rótulos; o padrão é `[]` A lista de arquivos C, C++, Objective-C e Objective-C++ que são incluídos como cabeçalhos por arquivos de origem nesta regra ou pelos usuários dessa biblioteca. Ao contrário dos hdrs, eles não são compilados separadamente das fontes.
`weak_sdk_frameworks`	Lista de strings. O padrão é `[]`. Nomes de frameworks do SDK com que há links fracos. Por exemplo, "MediaAccessibility". Diferente dos frameworks de SDK vinculados regularmente, os símbolos de frameworks vinculados fracamente não causam um erro se não estiverem presentes no momento da execução.

objc_library

Exibir origem da regra

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)

Essa regra produz uma biblioteca estática a partir dos arquivos de origem do Objective-C fornecidos.

Argumentos

Atributos
`name`	Nome, obrigatório Um nome exclusivo para essa segmentação.
`deps`	Lista de rótulos; o padrão é `[]` A lista de destinos que são vinculados para formar o pacote final.
`srcs`	Lista de rótulos. O padrão é `[]`. A lista de arquivos de origem e de cabeçalho C, C++, Objective-C e Objective-C++ e/ou arquivos de origem de assembly (`.s`, `.S` ou `.asm`) que são processados para criar o destino da biblioteca. Estes são os arquivos que você fez o check-in, além dos arquivos gerados. Os arquivos de origem são compilados em arquivos .o com o Clang. Arquivos de cabeçalho podem ser incluídos/importados por qualquer origem ou cabeçalho no atributo srcs desse destino, mas não por cabeçalhos em hdrs ou qualquer destino que dependa dessa regra. Além disso, arquivos .o pré-compilados podem ser fornecidos como srcs. Tenha cuidado para garantir a consistência na arquitetura dos arquivos .o fornecidos e do build para evitar erros de linker de símbolo ausentes.
`hdrs`	Lista de rótulos. O padrão é `[]`. A lista de arquivos de cabeçalho C, C++, Objective-C e Objective-C++ publicados por essa biblioteca para serem incluídos por fontes em regras dependentes. Esses cabeçalhos descrevem a interface pública da biblioteca e serão disponibilizados para inclusão por fontes nesta regra ou em regras dependentes. Os cabeçalhos que não precisam ser incluídos por um cliente dessa biblioteca precisam ser listados no atributo srcs. Eles serão compilados separadamente da origem se os módulos estiverem ativados.
`alwayslink`	Booleano; o padrão é `False` Se 1, qualquer pacote ou binário que dependa (diretamente ou indiretamente) dessa biblioteca vai vincular todos os arquivos de objeto dos arquivos listados em `srcs` e `non_arc_srcs`, mesmo que alguns não contenham símbolos referenciados pelo binário. Isso é útil se seu código não for chamado explicitamente por código no binário, por exemplo, se seu código for registrado para receber algum callback fornecido por algum serviço.
`copts`	Lista de strings. O padrão é `[]`. Sinalizações extras a serem transmitidas para o compilador. Sujeito à substituição de "Make variables" e à tokenização de shell Bourne. Essas sinalizações serão aplicadas somente a esse destino, e não àquelas de que ele depende ou às que dependem dele. Para o projeto Xcode gerado, os caminhos de diretório especificados usando flags "-I" em copts são analisados e precedidos por "$(WORKSPACE_ROOT)/" se forem caminhos relativos, e são adicionados aos caminhos de pesquisa de cabeçalho para o destino Xcode associado.
`defines`	Lista de strings. O padrão é `[]`. Sinalizações `-D` extras a serem transmitidas para o compilador. Elas precisam estar no formato `KEY=VALUE` ou simplesmente `KEY` e são transmitidas não apenas para o compilador desse destino (como `copts` são), mas também para todos os dependentes `objc_` desse destino. Sujeito à substituição de "Make variable" e tokenização de shell Bourne.
`enable_modules`	Booleano; o padrão é `False` Ativa o suporte a módulos clang (via -fmodules). Ao definir esse valor como 1, você poderá @importar cabeçalhos do sistema e outras targets: @import UIKit; @import path_to_package_target;
`implementation_deps`	Lista de rótulos; o padrão é `[]` A lista de outras bibliotecas de que o destino da biblioteca depende. Ao contrário do `deps`, os cabeçalhos e os caminhos de inclusão dessas bibliotecas (e todas as dependências transitivas) são usados apenas para a compilação dessa biblioteca, e não para as bibliotecas que dependem dela. As bibliotecas especificadas com `implementation_deps` ainda são vinculadas em destinos binários que dependem dessa biblioteca.
`includes`	Lista de strings. O padrão é `[]`. Lista de caminhos de pesquisa `#include/#import` a serem adicionados a essa segmentação e a todas as segmentações dependentes. Isso é para oferecer suporte a bibliotecas de terceiros e de código aberto que não especificam o caminho completo do espaço de trabalho nas instruções `#import/#include`. Os caminhos são interpretados em relação ao diretório do pacote, e os arquivos gen e bin raiz (por exemplo, `blaze-genfiles/pkg/includedir` e `blaze-out/pkg/includedir`) são incluídos além da raiz do cliente real. Ao contrário de COPTS, essas flags são adicionadas a essa regra e a todas as regras que dependem dela. Observação: não são as regras das quais ele depende. Tenha muito cuidado, porque isso pode ter efeitos de longo alcance. Em caso de dúvida, adicione flags "-iquote" a COPTS.
`linkopts`	Lista de strings. O padrão é `[]`. Flags extras para transmitir ao vinculador.
`module_map`	Rótulo; o padrão é `None` Um mapa personalizado do módulo Clang para este destino. Não é recomendável usar um mapa de módulo personalizado. A maioria dos usuários precisa usar mapas de módulo gerados pelo Bazel. Se especificado, o Bazel não vai gerar um mapa de módulo para esse destino, mas vai transmitir o mapa de módulo fornecido ao compilador.
`module_name`	String; o padrão é `""` Define o nome do módulo para esse destino. Por padrão, o nome do módulo é o caminho de destino com todos os símbolos especiais substituídos por _. Por exemplo, //foo/baz:bar pode ser importado como foo_baz_bar.
`non_arc_srcs`	Lista de rótulos. O padrão é `[]`. A lista de arquivos Objective-C que são processados para criar o destino da biblioteca que NÃO usa ARC. Os arquivos nesse atributo são tratados de forma muito semelhante aos do atributo srcs, mas são compilados sem o ARC ativado.
`pch`	Rótulo: o padrão é `None`. Arquivo de cabeçalho para ser adicionado a todos os arquivos de origem que estão sendo compilados (arc e não arc). O uso de arquivos pch é ativamente desencorajado em arquivos BUILD, e isso deve ser considerado descontinuado. Como os arquivos pch não são pré-compilados, isso não é uma melhoria na velocidade de build, mas apenas uma dependência global. Do ponto de vista da eficiência do build, é melhor incluir o que precisa diretamente nas origens, quando necessário.
`sdk_dylibs`	Lista de strings. O padrão é `[]`. Nomes das bibliotecas .dylib do SDK para vincular. Por exemplo, "libz" ou "libarchive". "libc++" é incluído automaticamente se o binário tiver origens C++ ou Objective-C++ na árvore de dependências. Ao vincular um binário, todas as bibliotecas nomeadas no gráfico de dependências transitivas desse binário são usadas.
`sdk_frameworks`	Lista de strings. O padrão é `[]`. Nomes de frameworks de SDK para vincular (por exemplo, "AddressBook", "QuartzCore"). "UIKit" e "Foundation" são sempre incluídos ao criar para as plataformas iOS, tvOS, visionOS e watchOS. No macOS, apenas "Foundation" é sempre incluído. Ao vincular um binário de nível superior da Apple, todos os frameworks do SDK listados no gráfico de dependência transitiva do binário são vinculados.
`sdk_includes`	Lista de strings. O padrão é `[]`. Lista de caminhos de pesquisa de `#include/#import` a serem adicionados a esse destino e a todos os destinos dependentes, em que cada caminho é relativo a `$(SDKROOT)/usr/include`.
`textual_hdrs`	Lista de rótulos; o padrão é `[]` A lista de arquivos C, C++, Objective-C e Objective-C++ que são incluídos como cabeçalhos por arquivos de origem nesta regra ou pelos usuários dessa biblioteca. Ao contrário dos hdrs, eles não são compilados separadamente das fontes.
`weak_sdk_frameworks`	Lista de strings. O padrão é `[]`. Nomes de frameworks de SDK para vincular de forma fraca. Por exemplo, "MediaAccessibility". Diferente dos frameworks de SDK vinculados regularmente, os símbolos de frameworks vinculados fracamente não causam um erro se não estiverem presentes no momento da execução.

available_xcodes

Exibir origem da regra

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

Duas instâncias da regra xcode_config podem depender de dois destinos desta regra para indicar as versões do Xcode disponíveis local e remotamente. Isso permite a seleção de uma versão oficial do Xcode entre os disponíveis coletivamente.

Argumentos

Atributos

name

Nome, obrigatório

Um nome exclusivo para essa segmentação.

default

Rótulo: não configurável; obrigatório

A versão padrão do Xcode para esta plataforma.

versions

Lista de rótulos; não configurável; o padrão é []

As versões do Xcode disponíveis nesta plataforma.

xcode_config

Acessar a origem da regra

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

Um único destino dessa regra pode ser referenciado pela flag de build --xcode_version_config para traduzir a flag --xcode_version em uma versão oficial aceita do Xcode. Isso permite a seleção de uma versão oficial do Xcode entre vários aliases registrados.

Argumentos

Atributos
`name`	Nome: obrigatório Um nome exclusivo para essa segmentação.
`default`	Rótulo: não configurável; o padrão é `None` A versão oficial padrão do xcode a ser usada. A versão especificada pelo destino `xcode_version` fornecido será usada se nenhuma sinalização de build `xcode_version` for especificada. Isso é necessário se algum `versions` estiver definido. Isso pode não ser definido se `remote_versions` ou `local_versions` estiverem definidos.
`local_versions`	Rótulo; não configurável; o padrão é `None` Os destinos `xcode_version` disponíveis localmente. Eles são usados com `local_versions` para selecionar uma versão mutuamente disponível. Isso pode não ser definido se `versions` estiver definido.
`remote_versions`	Rótulo; não configurável; o padrão é `None` Os destinos `xcode_version` que estão disponíveis remotamente. Eles são usados com `remote_versions` para selecionar uma versão mutuamente disponível. Pode não ser definido se `versions` estiver definido.
`versions`	Lista de marcadores; não configurável; o padrão é `[]` Destinos `xcode_version` aceitos que podem ser usados. Se o valor da flag de build `xcode_version` corresponder a um dos aliases ou ao número da versão de qualquer um dos destinos `xcode_version` fornecidos, o destino correspondente será usado. Isso pode não ser definido se `remote_versions` ou `local_versions` estiverem definidos.

xcode_version

Exibir origem da regra

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 uma única versão oficial do Xcode com aliases aceitáveis para essa versão. Consulte a regra xcode_config.

Argumentos

Atributos
`name`	Nome: obrigatório Um nome exclusivo para o destino.
`default_ios_sdk_version`	String; não configurável; o padrão é `""` A versão do SDK do iOS que é usada por padrão quando essa versão do Xcode está sendo usada. A flag de build `ios_sdk_version` vai substituir o valor especificado aqui.
`default_macos_sdk_version`	String; não configurável; o padrão é `""` A versão do SDK do macosx que é usada por padrão quando essa versão do Xcode está sendo usada. A flag de build `macos_sdk_version` vai substituir o valor especificado aqui.
`default_tvos_sdk_version`	String; não configurável; o padrão é `""` A versão do SDK do tvOS que é usada por padrão quando essa versão do Xcode está sendo usada. A flag de build `tvos_sdk_version` vai substituir o valor especificado aqui.
`default_visionos_sdk_version`	String; não configurável; o padrão é `""` A versão do SDK do VisionOS que é usada por padrão quando esta versão do Xcode está sendo usada. A flag de build `visionos_sdk_version` vai substituir o valor especificado aqui.
`default_watchos_sdk_version`	String; não configurável; o padrão é `""` A versão do SDK do watchOS que é usada por padrão quando essa versão do Xcode está sendo usada. A flag de build `watchos_sdk_version` vai substituir o valor especificado aqui.
`version`	String; não configurável; obrigatório O número da versão oficial de uma versão do Xcode.