Swift: จะใช้ PREPROCESSOR Flags (เช่น "#if DEBUG`) เพื่อใช้คีย์ API ได้อย่างไร

Question 1

ในObjective-Cบางครั้งการใช้ค่าคงที่สตริงคงที่เพื่อกำหนดคีย์ API ทางเลือก (ตัวอย่างเช่นเพื่อแยกความแตกต่างระหว่างคีย์ RELEASE และ DEBUG สำหรับแพ็คเกจการวิเคราะห์เช่น MixPanel, Flurry หรือ Crashlytics):

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

แล้ว ...

[Analytics startSession:API_KEY];

สิ่งนี้แปลเป็น Swift อย่างไรเนื่องจากคอมไพเลอร์ Swift ไม่ใช้ตัวประมวลผลล่วงหน้าอีกต่อไป

Question 2

Apple รวมการสนับสนุนแฟล็กก่อนโปรเซสเซอร์ Swift อย่างสมบูรณ์ในXcode 8ดังนั้นจึงไม่จำเป็นต้องตั้งค่าเหล่านี้ใน "อื่น ๆ Swift Flags" อีกต่อไป

การตั้งค่าใหม่นี้เรียกว่า "Active Compilation Conditions" ซึ่งให้การสนับสนุนระดับบนสุดสำหรับ Swift ที่เทียบเท่ากับแฟล็กตัวประมวลผลล่วงหน้า คุณใช้มันในลักษณะเดียวกับที่คุณทำกับ "Swift Flags อื่น ๆ " ทุกประการยกเว้นว่าไม่จำเป็นต้องนำหน้าค่าด้วย "-D" (ดังนั้นจึงสะอาดกว่าเล็กน้อย)

จากบันทึกประจำรุ่น Xcode 8 :

Active Compilation Conditionsเป็นการตั้งค่าการสร้างใหม่สำหรับการส่งผ่านแฟล็กการคอมไพล์ตามเงื่อนไขไปยังคอมไพเลอร์ Swift แต่ละองค์ประกอบของค่าของการตั้งค่านี้จะส่งผ่านไปยัง swiftc ที่ขึ้นต้นด้วย-D ในลักษณะเดียวกับที่องค์ประกอบของการPreprocessor Macrosส่งต่อเสียงดังด้วยคำนำหน้าเดียวกัน (22457329)

คุณใช้การตั้งค่าด้านบนดังนี้:

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

Question 3

อัปเดต: Xcode 8 รองรับสิ่งนี้โดยอัตโนมัติแล้วโปรดดูคำตอบของ @ DanLoewenherz ด้านบน

ก่อน Xcode 8 คุณยังสามารถใช้ Macros ได้ในลักษณะเดียวกัน:

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

อย่างไรก็ตามเพื่อให้ Swift มารับคุณจะต้องตั้งค่า "ธง Swift อื่น ๆ " ในการตั้งค่าการสร้างของเป้าหมาย:

เปิดการตั้งค่าการสร้างสำหรับเป้าหมายของคุณ
ค้นหา "ธงที่รวดเร็วอื่น ๆ "
เพิ่มมาโครที่คุณต้องการใช้นำหน้าด้วย-Dแฟล็ก

Question 4

เพื่อติดตามผลการสังเกตพยายามอย่าเก็บคีย์ / ความลับ api ไว้ในข้อความธรรมดาในที่เก็บ ใช้ระบบจัดการความลับเพื่อโหลดคีย์ / ความลับลงในตัวแปรสภาพแวดล้อมของผู้ใช้ มิฉะนั้นขั้นตอนที่ 1 เป็นสิ่งจำเป็นหากยอมรับได้

ใส่ "ความลับ" ในไฟล์ข้อความธรรมดาด้านบนในที่เก็บที่แนบมา
สร้างรายการ../set_keys.shที่มีรายการexport API_KEY_A='<plaintext_key_aef94c5l6>'(ใช้ใบเสนอราคาเดียวเพื่อป้องกันการประเมิน)
เพิ่มเฟสเรียกใช้สคริปต์ที่สามารถsource ../set_keys.shและย้ายไปที่ด้านบนของคำสั่งดำเนินการ
ใน Build Settings> Preprocessor Macros ให้เพิ่มเพื่อกำหนดตามความจำเป็นเช่น API_KEY_A="$API_KEY_A"

ที่รวบรวมตัวแปรสภาพแวดล้อมไว้ในการกำหนดคอมไพเลอร์ซึ่งจะใช้ในภายหลังในการเรียกใช้ clang สำหรับไฟล์ต้นทาง

โครงสร้างไดเร็กทอรีตัวอย่าง

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

Question 5

ในแพ็คเกจที่รวดเร็วคุณต้องทำสิ่งนี้ภายในswiftSettingsอาร์กิวเมนต์.targetในPackage.swiftไฟล์ของคุณ ใช้defineวิธีการ(เอกสารของ Apple)หรือเอกสาร Swift

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

หน้าตาของฉันเป็นแบบนี้และได้ผล!

            swiftSettings: [
               .define("VAPOR")
            ]

ในรหัสของฉันฉันสามารถรวบรวมตามเงื่อนไขโดยใช้สิ่งนี้:

#if VAPOR