README_tc.md

SwiftNEW

English · 繁中 · 简中 · 粵語 · 日本語 · 한국어

現代、SwiftUI 原生的 「最新功能」 展示框架,適用於所有 Apple 平台 — 內建動畫漸層背景、玻璃效果、遠端資料載入,並完整支援 RTL 與在地化。

🎨 圖庫

淺色	深色

🚀 快速開始

1. 加入套件:在 Xcode → File → Add Package Dependencies…

Important

套件 URL

https://github.com/1998code/SwiftNEWKit

2. 加入 data.json 至 App Bundle:

Tip

範例版本說明 JSON

[
  {
    "version": "1.0",
    "new": [
      { "icon": "star.fill", "title": "歡迎", "subtitle": "立即上手", "body": "感謝您下載我們的 App!" }
    ]
  }
]

3. 在 View 中使用:

Note

最簡 SwiftUI 整合

import SwiftNEW

struct ContentView: View {
    @State private var showNew = false
    var body: some View {
        SwiftNEW(show: $showNew)
    }
}

完成 — SwiftNEW 會在 App 版本變更時自動觸發。

✨ 功能

功能	起始版本	說明
🔍 內嵌搜尋	6.3.0	依標題 / 副標題 / 內文過濾目前版本說明
🏷️ 自訂標題	6.3.0	headingStyle:.version、.versionOnly、.appName
🎯 圖示樣式	6.3.0	iconStyle:.filled(色塊底)或 .plain(僅圖示)
🔢 可選建置號碼	6.3.0	透過 showBuild: false 隱藏建置號碼
🎨 浮動粒子特效	6.3.0	全新 .particles 特效(TimelineView + Canvas)
🎯 多種呈現方式	6.2.0	.sheet、.fullScreenCover、.embed
🌈 自適應文字色	6.2.0	按鈕文字自動依背景對比
🛠️ 簡化初始化	6.2.0	直接傳值 — 無需 .constant() 包裝
🪟 玻璃擬態	5.5.0	透明度可調的現代模糊效果
🌈 網格與線性漸層	5.3.0	動畫漸層背景
🥽 visionOS 支援	4.1.0	原生空間運算
🔄 自動觸發	4.0.0	版本/建置變更時自動顯示
🎄 特殊效果	3.9.0	.christmas 雪花、.particles 彩虹
📱 Drop 通知	3.5.0	iOS 風格橫幅通知
🔥 Firebase Realtime DB	3.0.0	即時內容更新
🌐 遠端 JSON	3.0.0	從任意 REST 端點載入
📚 版本歷史	2.0.0	瀏覽所有先前版本

功能展示

網格漸層 (5.3+)	visionOS (4.1+)

App 圖示 (3.9.6+)	歷史 (2.0+)

📚 深入了解

文件	涵蓋內容
Configuration	全部參數、範例、資料來源(本地 / 遠端 / Firebase)、資料模型
Platform Support & Installation	支援的 OS 版本、需求、功能對照表、SPM 設定
Contributing	專案結構、開發環境、PR 規範、疑難排解

📄 授權

SwiftNEW 採用 MIT License — 最寬鬆的開源授權之一。

	詳情
✅ 可以	用於商業 App(包括 App Store 付費 App)、修改、再發佈,並整合到閉源軟體中
📝 必須	在您的專案中保留原始版權與授權聲明
⚠️ 無擔保	軟體按「現況」提供 — 作者不對使用所造成之任何問題負責

完整內容請見 LICENSE。

💖 贊助支持

贊助商	資源
	雲端基礎設施
	AI 文件問答