Regras do Objective-C

Informar um problema Ver fonte Nightly · 8.3 · 8.2 · 8.1 ·

Regras

objc_import

Ver origem da regra
objc_import(name, deps, hdrs, alwayslink, archives, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, includes, package_metadata, restricted_to, sdk_dylibs, sdk_frameworks, sdk_includes, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, weak_sdk_frameworks)

Essa regra encapsula uma biblioteca estática já compilada na forma de um arquivo .a. Também é possível exportar cabeçalhos e recursos usando os mesmos atributos compatíveis com objc_library.

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 de que este 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 nessa regra ou em regras dependentes. Os cabeçalhos que não devem 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.

Booleano; o padrão é False

Se for 1, qualquer pacote ou binário que dependa (direta 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 o código não for chamado explicitamente pelo código no binário, por exemplo, se o código se registrar para receber algum callback fornecido por algum serviço.
archives

Lista de marcadores; 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 as raízes genfiles e bin (por exemplo, blaze-genfiles/pkg/includedir e blaze-out/pkg/includedir) são incluídas além da raiz real do cliente.

Ao contrário do COPTS, essas flags são adicionadas a essa regra e a todas as regras que dependem dela. Observação: não as regras de que ele depende. Tome muito cuidado, porque isso pode ter efeitos abrangentes. Em caso de dúvida, adicione flags "-iquote" a COPTS.

sdk_dylibs

Lista de strings. O padrão é [].

Nomes das bibliotecas .dylib do SDK a serem vinculadas. Por exemplo, "libz" ou "libarchive". A "libc++" é incluída automaticamente se o binário tiver fontes C++ ou Objective-C++ na árvore de dependências. Ao vincular um binário, todas as bibliotecas nomeadas no gráfico de dependência transitiva 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").

Ao vincular um binário de nível superior da Apple, todos os frameworks do SDK listados no gráfico de dependência transitiva desse binário são vinculados.

sdk_includes

Lista de strings. O padrão é [].

Lista de caminhos de pesquisa #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++ incluídos como cabeçalhos por arquivos de origem nesta regra ou por usuários desta biblioteca. Ao contrário dos hdrs, eles não serão compilados separadamente das fontes.
weak_sdk_frameworks

Lista de strings. O padrão é [].

Nomes de frameworks do SDK para vincular de forma fraca. Por exemplo, "MediaAccessibility". Ao contrário dos frameworks de SDK vinculados regularmente, os símbolos de frameworks vinculados de forma fraca não causam um erro se não estiverem presentes no tempo de execução.

objc_library

Ver origem da regra
objc_library(name, deps, srcs, data, hdrs, alwayslink, compatible_with, conlyopts, copts, cxxopts, defines, deprecation, enable_modules, exec_compatible_with, exec_group_compatible_with, exec_properties, features, implementation_deps, includes, linkopts, module_map, module_name, non_arc_srcs, package_metadata, pch, restricted_to, sdk_dylibs, sdk_frameworks, sdk_includes, stamp, tags, target_compatible_with, testonly, textual_hdrs, toolchains, visibility, weak_sdk_frameworks)

Essa regra produz uma biblioteca estática dos arquivos de origem Objective-C especificados.

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 de que este destino depende.
srcs

Lista de rótulos. O padrão é [].

A lista de arquivos de origem e de cabeçalho em C, C++, Objective-C e Objective-C++, e/ou arquivos de origem assembly (`.s`, `.S` ou `.asm`) que são processados para criar o destino da biblioteca. São seus arquivos check-in e todos os arquivos gerados. Os arquivos de origem são compilados em arquivos .o com o Clang. Os arquivos de cabeçalho podem ser incluídos/importados por qualquer origem ou cabeçalho no atributo srcs dessa meta, mas não por cabeçalhos em hdrs ou metas que dependam 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 da build para evitar erros de vinculador de símbolos 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 nessa regra ou em regras dependentes. Os cabeçalhos que não devem 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.

Booleano; o padrão é False

Se for 1, qualquer pacote ou binário que dependa (direta 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 o código não for chamado explicitamente pelo código no binário, por exemplo, se o código se registrar para receber algum callback fornecido por algum serviço.
conlyopts

Lista de strings. O padrão é [].

Sinalizações extras a serem transmitidas ao compilador para arquivos C. Sujeito à substituição de "Criar variável" e à tokenização do shell Bourne. Essas flags só se aplicam a essa meta, não àquelas de que ela depende ou que dependem dela.

No projeto do Xcode gerado, os caminhos de diretório especificados usando flags "-I" em copts são analisados, precedidos por "$(WORKSPACE_ROOT)/" se forem caminhos relativos e adicionados aos caminhos de pesquisa de cabeçalho para o destino associado do Xcode.

copts

Lista de strings. O padrão é [].

Flags extras a serem transmitidas ao compilador. Sujeito à substituição de "Criar variável" e à tokenização do shell Bourne. Essas flags só se aplicam a essa meta, não àquelas de que ela depende ou que dependem dela.

No projeto do Xcode gerado, os caminhos de diretório especificados usando flags "-I" em copts são analisados, precedidos por "$(WORKSPACE_ROOT)/" se forem caminhos relativos e adicionados aos caminhos de pesquisa de cabeçalho para o destino associado do Xcode.

cxxopts

Lista de strings. O padrão é [].

Flags extras a serem transmitidas ao compilador para arquivos Objective-C++ e C++. Sujeito à substituição de "Criar variável" e à tokenização do shell Bourne. Essas flags só se aplicam a essa meta, não àquelas de que ela depende ou que dependem dela.

No projeto do Xcode gerado, os caminhos de diretório especificados usando flags "-I" em copts são analisados, precedidos por "$(WORKSPACE_ROOT)/" se forem caminhos relativos e adicionados aos caminhos de pesquisa de cabeçalho para o destino associado do Xcode.

defines

Lista de strings. O padrão é [].

Flags -D extras a serem transmitidas ao compilador. Eles precisam estar no formato KEY=VALUE ou simplesmente KEY e são transmitidos não apenas ao compilador desse destino (como copts), mas também a todos os dependentes objc_ desse destino. Sujeito à substituição de "Criar variável" e à tokenização do shell Bourne.
enable_modules

Booleano; o padrão é False

Ativa o suporte ao módulo clang (usando -fmodules). Definir como 1 permite importar cabeçalhos do sistema e outros destinos: @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 caminhos de inclusão dessas bibliotecas (e todas as dependências transitivas delas) são usados apenas para a compilação dessa biblioteca, e não das 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 as raízes genfiles e bin (por exemplo, blaze-genfiles/pkg/includedir e blaze-out/pkg/includedir) são incluídas além da raiz real do cliente.

Ao contrário do COPTS, essas flags são adicionadas a essa regra e a todas as regras que dependem dela. Observação: não as regras de que ele depende. Tome muito cuidado, porque isso pode ter efeitos abrangentes. Em caso de dúvida, adicione flags "-iquote" a COPTS.

linkopts

Lista de strings. O padrão é [].

Flags extras a serem transmitidas ao vinculador.
module_map

Rótulo; o padrão é None

Mapa de módulo Clang personalizado para essa meta. O uso de um mapa de módulo personalizado não é recomendado. A maioria dos usuários precisa usar mapas de módulos 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 essa meta. 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 processados para criar o destino da biblioteca que NÃO usa a contagem automática de referências (ARC, na sigla em inglês). Os arquivos nesse atributo são tratados de maneira 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 a ser adicionado a cada arquivo de origem compilado (arc e não arc). O uso de arquivos pch é desencorajado ativamente nos arquivos BUILD e 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 de build, é melhor incluir o que você precisa diretamente nas fontes onde é necessário.
sdk_dylibs

Lista de strings. O padrão é [].

Nomes das bibliotecas .dylib do SDK a serem vinculadas. Por exemplo, "libz" ou "libarchive". A "libc++" é incluída automaticamente se o binário tiver fontes C++ ou Objective-C++ na árvore de dependências. Ao vincular um binário, todas as bibliotecas nomeadas no gráfico de dependência transitiva 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").

Ao vincular um binário de nível superior da Apple, todos os frameworks do SDK listados no gráfico de dependência transitiva desse binário são vinculados.

sdk_includes

Lista de strings. O padrão é [].

Lista de caminhos de pesquisa #include/#import a serem adicionados a esse destino e a todos os destinos dependentes, em que cada caminho é relativo a $(SDKROOT)/usr/include.
stamp

Booleano; o padrão é False

textual_hdrs

Lista de rótulos. O padrão é [].

A lista de arquivos C, C++, Objective-C e Objective-C++ incluídos como cabeçalhos por arquivos de origem nesta regra ou por usuários desta biblioteca. Ao contrário dos hdrs, eles não serão compilados separadamente das fontes.
weak_sdk_frameworks

Lista de strings. O padrão é [].

Nomes de frameworks do SDK para vincular de forma fraca. Por exemplo, "MediaAccessibility". Ao contrário dos frameworks de SDK vinculados regularmente, os símbolos de frameworks vinculados de forma fraca não causam um erro se não estiverem presentes no tempo de execução.