大家好，我是K哥。一名獨(dú)立開發(fā)者，同時(shí)也是Swift開發(fā)框架【Aquarius】的作者，悅記和愛尋車app的開發(fā)者。

Aquarius開發(fā)框架旨在幫助獨(dú)立開發(fā)者和中小型團(tuán)隊(duì)，完成iOS App的快速實(shí)現(xiàn)與迭代。使用框架開發(fā)將給你帶來簡(jiǎn)單、高效、易維護(hù)的編程體驗(yàn)。

Aquarius 是一個(gè)為 Swift 開發(fā)者打造的高效、輕量級(jí)開發(fā)框架，致力于提供簡(jiǎn)潔統(tǒng)一的 API 設(shè)計(jì)，幫助開發(fā)者快速構(gòu)建高質(zhì)量的 iOS 應(yīng)用。本文將重點(diǎn)介紹其核心工具集 A.swift 的使用方法。

Aquarius 框架中的 A.swift（簡(jiǎn)稱 A）是一個(gè)功能強(qiáng)大的工具箱，它將常用的開發(fā)功能封裝為靜態(tài)方法，覆蓋了 UI 構(gòu)建、顏色圖片、數(shù)據(jù)存儲(chǔ)、文件操作、事件管理、日志、內(nèi)購(gòu)等高頻場(chǎng)景。使用 A，開發(fā)者可以告別繁瑣的底層調(diào)用，大幅提升開發(fā)效率與代碼整潔度。

一、A.swift 是什么？

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

其主要優(yōu)勢(shì)包括：

• 統(tǒng)一入口：所有功能通過 A 訪問，降低記憶成本
• 類型安全：多數(shù)接口設(shè)計(jì)為類型安全或可選值，避免隱性崩潰
• 功能完備：涵蓋 UI、主題、存儲(chǔ)、系統(tǒng)交互、日志、支付等常用場(chǎng)景
• 現(xiàn)代并發(fā)支持：如 IAP 模塊使用 async/await 封裝，適配 Swift 并發(fā)編程

二、核心模塊概覽

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

三、實(shí)戰(zhàn)演示：感受編碼效率的飛躍

3.1 快速創(chuàng)建并添加按鈕

傳統(tǒng)方式：

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控件創(chuàng)建方式的不同，統(tǒng)一UI控件創(chuàng)建方式。

3.2 使用主題色與系統(tǒng)圖標(biāo)

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

統(tǒng)一管理顏色與圖標(biāo)，輕松適配暗黑模式與主題切換。

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 創(chuàng)建日歷事件

A.calendarEvent.add(title: "發(fā)布會(huì)", startDate: start, endDate: end) { result in
    switch result {
    case .success(let id): A.log.info("創(chuàng)建成功：\(id)")
    case .failure(let err): A.log.error("創(chuàng)建失?。篭(err)")
    }
}

自動(dòng)處理權(quán)限申請(qǐng)與事件添加，回調(diào)清晰。

3.6 分級(jí)日志

A.log.debug("用戶點(diǎn)擊按鈕")
A.log.warning("網(wǎng)絡(luò)請(qǐng)求超時(shí)")
A.log.error("解析失?。篭(error)")

日志自帶 emoji 和等級(jí)標(biāo)識(shí)，調(diào)試更直觀。

3.7 發(fā)起內(nèi)購(gòu)

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("購(gòu)買成功")
        }
    } catch {
        A.log.error("購(gòu)買失敗：\(error)")
    }
}

基于現(xiàn)代 StoreKit API，支持 async/await，邏輯清晰。

四、最佳實(shí)踐與注意事項(xiàng)

4.1 錯(cuò)誤處理要到位

A 中多數(shù)可能出錯(cuò)的操作都會(huì)通過 Result、throws 或可選值來表示失敗，請(qǐng)務(wù)必處理這些情況，避免直接使用 try! 或強(qiáng)制解包。

4.2 權(quán)限管理不能忘

如使用 A.calendarEvent 或 A.reminderEvent，請(qǐng)確保已在 Info.plist 中添加相應(yīng)權(quán)限說明，并在使用前檢查授權(quán)狀態(tài)。

4.3 線程安全需注意

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

4.4 結(jié)合 MVVM 架構(gòu)

你可以在 ViewModel 中直接使用 A.file、A.userDefaults、A.iap 等模塊，將平臺(tái)相關(guān)代碼與 UI 邏輯分離：

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

五、總結(jié)

A.swift 作為 Aquarius 框架中的"瑞士軍刀"，極大地簡(jiǎn)化了 iOS 開發(fā)中常見的任務(wù)流程。無論是創(chuàng)建界面、管理數(shù)據(jù)、記錄日志，還是處理內(nèi)購(gòu)和系統(tǒng)事件，A 都提供了簡(jiǎn)潔而強(qiáng)大的接口。

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

立即體驗(yàn)Aquarius：

第一步：探索資源

• ? Star & Fork 框架源碼： GitHub - JZXStudio/Aquarius - 支持項(xiàng)目發(fā)展
• ? Star & Fork 框架文檔： ZRead - JZXStudio/Aquarius - 項(xiàng)目介紹文檔，深入了解框架
• ? Star & Fork 悅記源碼： GitHub - JZXStudio/yuenote - 完整案例，深入了解框架使用方式

第二步：體驗(yàn)效果

• ?? 下載示例APP： 悅記 | 愛尋車 - 感受真實(shí)項(xiàng)目中的流暢體驗(yàn)

第三步：溝通交流

• ?? 提交Issue： GitHub Issues - 反饋問題或建議
• ?? 聯(lián)系與反饋： studio_jzx@163.com - 直接交流開發(fā)心得