大家好，我是K哥。一名獨立開發者，同時也是Swift開發框架【Aquarius】的作者，悦記和愛尋車app的開發者。

Aquarius開發框架旨在幫助獨立開發者和中小型團隊，完成iOS App的快速實現與迭代。使用框架開發將給你帶來簡單、高效、易維護的編程體驗。

Aquarius 是一個為 Swift 開發者打造的高效、輕量級開發框架，致力於提供簡潔統一的 API 設計，幫助開發者快速構建高質量的 iOS 應用。本文將重點介紹其核心工具集 A.swift 的使用方法。

Aquarius 框架中的 A.swift（簡稱 A）是一個功能強大的工具箱，它將常用的開發功能封裝為靜態方法，覆蓋了 UI 構建、顏色圖片、數據存儲、文件操作、事件管理、日誌、內購等高頻場景。使用 A，開發者可以告別繁瑣的底層調用，大幅提升開發效率與代碼整潔度。

一、A.swift 是什麼？

A 是 Aquarius 框架中的核心便捷層，以命名空間（Namespace）的形式組織代碼，提供了一系列靜態屬性和方法，讓開發者能夠通過類似 A.ui、A.color、A.file 這樣的語法快速調用功能模塊。

其主要優勢包括：

• 統一入口：所有功能通過 A 訪問，降低記憶成本
• 類型安全：多數接口設計為類型安全或可選值，避免隱性崩潰
• 功能完備：涵蓋 UI、主題、存儲、系統交互、日誌、支付等常用場景
• 現代併發支持：如 IAP 模塊使用 async/await 封裝，適配 Swift 併發編程

二、核心模塊概覽

下面我們簡要介紹 A 中常用的子模塊及其典型用途：

三、實戰演示：感受編碼效率的飛躍

3.1 快速創建並添加按鈕

傳統方式：

let button = UIButton(type: .system)
button.addTarget(self, action: #selector(submitTapped), for: .touchUpInside)

使用A.swift：

let button = A.ui.button
button.addTouchUpInsideBlock { [weak self] control in
    ...
}
let label = A.ui.label
let imageView = A.ui.imageView
let tableView = A.ui.tableView
...

告別不同UI控件創建方式的不同，統一UI控件創建方式。

3.2 使用主題色與系統圖標

view.backgroundColor = A.color.blackColor
imageView.image = A.image.systemImage(systemName: "star.fill")

統一管理顏色與圖標，輕鬆適配暗黑模式與主題切換。

3.3 讀寫 UserDefaults

//寫入
A.userDefaults("group.com.jzx.app").forKey("username")
A.userDefaults("group.com.jzx.app").setValue("張三", forKey: "username")
//讀取
let name: String? = A.userDefaults("group.com.jzx.app").getStringValue("username")

支持 App Group，並提供類型安全的讀取接口。

3.4 文件操作

let path = A.file.pathFromDocuments("data/user.json")
if !A.file.isExist(path) {
    try? A.file.createFolder(at: "data")
}
// 寫入文件...

封裝常用文件操作方法，提升代碼可讀性。

3.5 創建日曆事件

A.calendarEvent.add(title: "發佈會", startDate: start, endDate: end) { result in
    switch result {
    case .success(let id): A.log.info("創建成功：\(id)")
    case .failure(let err): A.log.error("創建失敗：\(err)")
    }
}

自動處理權限申請與事件添加，回調清晰。

3.6 分級日誌

A.log.debug("用户點擊按鈕")
A.log.warning("網絡請求超時")
A.log.error("解析失敗：\(error)")

日誌自帶 emoji 和等級標識，調試更直觀。

3.7 發起內購

Task {
    do {
        let products = try await A.iap.fetchProducts(["com.jzx.pro"])
        if let product = products.first {
            try await A.iap.purchase(product: product)
            A.log.info("購買成功")
        }
    } catch {
        A.log.error("購買失敗：\(error)")
    }
}

基於現代 StoreKit API，支持 async/await，邏輯清晰。

四、最佳實踐與注意事項

4.1 錯誤處理要到位

A 中多數可能出錯的操作都會通過 Result、throws 或可選值來表示失敗，請務必處理這些情況，避免直接使用 try! 或強制解包。

4.2 權限管理不能忘

如使用 A.calendarEvent 或 A.reminderEvent，請確保已在 Info.plist 中添加相應權限説明，並在使用前檢查授權狀態。

4.3 線程安全需注意

涉及 UI 更新的操作請確保在主線程執行。A.iap 等異步方法已自動處理線程切換，但仍建議使用 MainActor 或 DispatchQueue.main 更新界面。

4.4 結合 MVVM 架構

你可以在 ViewModel 中直接使用 A.file、A.userDefaults、A.iap 等模塊，將平台相關代碼與 UI 邏輯分離：

class SettingViewModel {
    func clearCache() {
        let cachePath = A.file.pathFromCaches("")
        try? A.file.removeItem(cachePath)
    }
}

五、總結

A.swift 作為 Aquarius 框架中的"瑞士軍刀"，極大地簡化了 iOS 開發中常見的任務流程。無論是創建界面、管理數據、記錄日誌，還是處理內購和系統事件，A 都提供了簡潔而強大的接口。

如果你正在尋找一個能提升開發效率、減少樣板代碼的 Swift 工具集，不妨試試 Aquarius 框架中的 A.swift。

立即體驗Aquarius：

第一步：探索資源

• ⭐ Star & Fork 框架源碼： GitHub - JZXStudio/Aquarius - 支持項目發展
• ⭐ Star & Fork 框架文檔： ZRead - JZXStudio/Aquarius - 項目介紹文檔，深入瞭解框架
• ⭐ Star & Fork 悦記源碼： GitHub - JZXStudio/yuenote - 完整案例，深入瞭解框架使用方式

第二步：體驗效果

• 📱 下載示例APP： 悦記 | 愛尋車 - 感受真實項目中的流暢體驗

第三步：溝通交流

• 💬 提交Issue： GitHub Issues - 反饋問題或建議
• 💌 聯繫與反饋： studio_jzx@163.com - 直接交流開發心得