README_hc.md

SwiftNEW

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

為晒所有 Apple 平台而設嘅現代 SwiftUI 原生 「新功能」 展示框架 — 內置動畫漸層背景、玻璃效果、遠端資料載入,仲有 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)
    }
}

搞掂 — App 版本一變,SwiftNEW 就會自動彈出。

✨ 功能

功能	起始版本	說明
🔍 內嵌搜尋	6.3.0	用標題 / 副標題 / 內文過濾當前版本說明
🏷️ 自訂標題	6.3.0	headingStyle:.version、.versionOnly、.appName
🎯 圖示樣式	6.3.0	iconStyle:.filled(有色塊底)或 .plain(淨圖示)
🔢 可選 Build 編號	6.3.0	用 showBuild: false 隱藏 build 編號
🎨 浮動粒子特效	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	版本 / build 一變就自動顯示
🎄 特殊效果	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)、改、再發佈,仲可以塞入閉源軟件
📝 必須	喺你個 project 入面保留原本嘅版權同授權聲明
⚠️ 無擔保	軟件按「現況」提供 — 作者唔會對使用而引起嘅問題負責

完整內容睇 LICENSE。

💖 贊助支持

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