Swift: como usar sinalizadores de PREPROCESSOR (como `#if DEBUG`) para implementar chaves de API?

Question 1

Em Objective-Calgumas vezes era útil para usar as constantes string estática para definir chaves de API alternativos (por exemplo, para diferenciar entre a liberação e as chaves de depuração para pacotes de análise, como MixPanel, Flurry ou Crashlytics):

#if DEBUG
static NSString *const API_KEY = @"KEY_A";
#else
static NSString *const API_KEY = @"KEY_B";
#endif

e depois...

[Analytics startSession:API_KEY];

Como isso se traduz em Swift, já que o compilador Swift não usa mais um pré-processador?

Question 2

A Apple incluiu suporte completo para sinalizadores de pré-processador Swift a partir do Xcode 8 , então não é mais necessário definir esses valores em "Outros sinalizadores Swift".

A nova configuração é chamada de "Condições de compilação ativa", que fornece suporte de nível superior para o equivalente Swift dos sinalizadores de pré-processador. Você o usa exatamente da mesma maneira que faria com "Outros sinalizadores Swift", exceto que não há necessidade de acrescentar um "-D" ao prefixo (portanto, é apenas um pouco mais limpo).

Das notas de lançamento do Xcode 8 :

Active Compilation Conditionsé uma nova configuração de construção para passar sinalizadores de compilação condicional para o compilador Swift. Cada elemento do valor desta configuração passa para swiftc prefixado com -D, da mesma forma que elementos de Preprocessor Macrospassam para clang com o mesmo prefixo. (22457329)

Você usa a configuração acima assim:

#if DEBUG
    let accessToken = "DebugAccessToken"
#else
    let accessToken = "ProductionAccessToken"
#endif

Question 3

ATUALIZADO: o Xcode 8 agora suporta isso automaticamente, consulte a resposta de @DanLoewenherz acima.

Antes do Xcode 8, você ainda podia usar macros da mesma maneira:

#if DEBUG
let apiKey = "KEY_A"
#else
let apiKey = "KEY_B"
#endif

No entanto, para que eles sejam captados pelo Swift, você precisa definir "Outros sinalizadores Swift" nas configurações de construção do seu alvo:

Abra as configurações de compilação para seu destino
Pesquise por "outras sinalizações rápidas"
Adicione as macros que deseja usar, precedidas do -Dsinalizador

Question 4

Como observação de acompanhamento, tente não manter as chaves / segredos da API em texto simples no repositório. Use um sistema de gerenciamento de segredos para carregar as chaves / segredos nas variáveis de ambiente do usuário. Caso contrário, a etapa 1 é necessária, se aceitável.

Coloque os "segredos" em um arquivo de texto simples acima no repositório anexo
Crie um ../set_keys.shque contenha uma lista de export API_KEY_A='<plaintext_key_aef94c5l6>'(use aspas simples para evitar avaliação)
Adicione uma fase de script de execução que possa source ../set_keys.she mova-a para o topo da ordem de execução
Em Build Settings> Preprocessor Macros, adicione às definições conforme necessário, como API_KEY_A="$API_KEY_A"

Isso captura a variável de ambiente na definição do compilador, que é usada posteriormente em cada invocação do clang para cada arquivo de origem.

Exemplo de estrutura de diretório

[10:33:15] ~/code/memo yes? tree -L 2 .
.
├── Memo
│   ├── Memo
│   ├── Memo.xcodeproj
│   ├── Memo.xcworkspace
│   ├── Podfile
│   ├── Podfile.lock
│   └── Pods
└── keys

Question 5

Em pacotes swift, você tem que fazer isso dentro do swiftSettingsargumento .targetem seu Package.swiftarquivo. Use o definemétodo (documentação da Apple) ou documentação do Swift

targets: [
.target(name: String,
            dependencies: [Target.Dependency],
            path: String?,
            exclude: [String]?,
            sources: [String]?,,
            cSettings: [CSetting]?,
            cxxSettings: [CXXSetting]?,
            swiftSettings: [SwiftSetting]?,
            linkerSettings: [LinkerSetting]?),

O meu é assim e funciona!

            swiftSettings: [
               .define("VAPOR")
            ]

no meu código, posso compilar condicionalmente usando isto:

#if VAPOR