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

大家好，我是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 中常用的子模塊及其典型用途：

模塊名	功能說明
A.ui	快速創建常用 UI 控件
A.color / A.image	主題色、系統圖標與圖片工具
A.userDefaults(_:)	UserDefaults 便捷封裝，支持 App Group
A.file	文件路徑、目錄與文件操作
A.calendarEvent	日歷事件管理（基于 EventKit）
A.log	分級日志輸出，支持 emoji 標識
A.iap	內購流程封裝，基于 StoreKit 現代 API

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

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 - 直接交流開發心得