Swift: jak używać flag PREPROCESSOR (takich jak „#if DEBUG”) do implementacji kluczy API?

W Objective-Cbyło czasami warto używać statycznych stałych ciągów zdefiniować alternatywne klucze API (na przykład odróżnić zwolnić i klucze debugowania dla analityki pakietów, jak MixPanel, Flurry lub Crashlytics):

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

i wtedy...

[Analytics startSession:API_KEY];

Jak to się przekłada na Swift, skoro kompilator Swift nie używa już preprocesora?

Firma Apple zapewniła pełną obsługę flag preprocesora Swift od Xcode 8 , więc nie jest już konieczne ustawianie tych wartości w „Inne flagi Swift”.

Nowe ustawienie nosi nazwę „Aktywne warunki kompilacji” i zapewnia obsługę na najwyższym poziomie odpowiednika flag preprocesora w języku Swift. Używasz go w dokładnie taki sam sposób, jak „Inne flagi Swift”, z wyjątkiem tego, że nie ma potrzeby poprzedzania wartości znakiem „-D” (więc jest to trochę czystsze).

Z informacji o wersji Xcode 8 :

Active Compilation Conditionsto nowe ustawienie kompilacji do przekazywania flag kompilacji warunkowej do kompilatora Swift. Każdy element wartości tego ustawienia przechodzi do swiftc z prefiksem -D, w taki sam sposób, w jaki elementy Preprocessor Macrospass to clang z tym samym prefiksem. (22457329)

Używasz powyższego ustawienia w następujący sposób:

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

AKTUALIZACJA: Xcode 8 obsługuje teraz to automatycznie, zobacz odpowiedź @ DanLoewenherz powyżej.

Przed Xcode 8 nadal można było używać makr w ten sam sposób:

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

Aby jednak zostały one odebrane przez Swifta, musisz ustawić „Inne flagi szybkiej” w ustawieniach budowy celu:

• Otwórz ustawienia kompilacji dla swojego celu
• Wyszukaj „inne szybkie flagi”
• Dodaj makra, których chcesz użyć, poprzedzone -Dflagą

Jako dalsza obserwacja, staraj się nie przechowywać kluczy / kluczy interfejsu API w zwykłym tekście w repozytorium. Użyj systemu zarządzania sekretami, aby załadować klucze / sekrety do zmiennych środowiskowych użytkownika. W przeciwnym razie krok 1 jest konieczny, jeśli jest akceptowalny.

1. Umieść „sekrety” w pliku zwykłego tekstu powyżej w załączającym repozytorium
2. Utwórz, ../set_keys.shktóry zawiera listę export API_KEY_A='<plaintext_key_aef94c5l6>'(użyj pojedynczego cudzysłowu, aby zapobiec ocenie)
3. Dodaj fazę skryptu uruchamiania, która może source ../set_keys.shi przenieś ją na górę kolejności wykonania
4. W Ustawieniach kompilacji> Makra preprocesora, w razie potrzeby dodaj definicje, takie jak API_KEY_A="$API_KEY_A"

To przechwytuje zmienną środowiskową do definicji kompilatora, która jest później używana w każdym wywołaniu clang dla każdego pliku źródłowego.

Przykładowa struktura katalogów

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

W szybkich pakietach musisz to zrobić wewnątrz swiftSettingsargumentu do .targetw swoim Package.swiftpliku. Użyj definemetody (dokumentacja Apple) lub dokumentacji Swift

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

Mój wygląda tak i działa!

            swiftSettings: [
               .define("VAPOR")
            ]

w moim kodzie mogę warunkowo skompilować za pomocą tego:

#if VAPOR