Skip to content

README_hc.md

Latest commit

 

History

History
154 lines (123 loc) · 8.98 KB

README_hc.md

File metadata and controls

154 lines (123 loc) · 8.98 KB
Raw
SNK

SwiftNEW

Stable Beta Validate JSON Files Swift Version Platforms License

English · 繁中 · 简中 · 粵語 · 日本語 · 한국어 · Français · Español

為晒所有 Apple 平台而設嘅現代 SwiftUI 原生 「新功能」 展示框架 — 內置動畫漸層背景、玻璃效果、遠端資料載入,仲有 RTL 同在地化全面支援。

image

🎨 圖庫

淺色 深色
Light Dark

🚀 快速開始

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 就會自動彈出。

已經獲 Apple 批准嘅 CarPlay host app，只可以喺更新內容直接符合獲批車載類別時用 SwiftNEWCarPlayTemplateFactory；一般產品 changelog 唔會自動符合資格。Scene lifecycle、內容同 entitlement 限制請睇 CarPlay 整合指南。

✨ 功能

功能 起始版本 說明
⌚ 原生 watchOS 支援 27.0 SwiftNEW 而家支援 watchOS 8，提供精簡嘅目前版本 / 歷史 / 更新畫面、自適應視覺後備效果，同埋配套 App 嘅 App Store 自動查詢
🚘 CarPlay Template 支援 27.0 已獲 Apple 批准嘅 CarPlay host app 可以用同一套本地或遠端 JSON，喺原生 template 顯示符合獲批車載用途嘅更新內容
📥 獨立版本說明載入器 27.0 SwiftNEWReleaseNotesLoader 唔使建立 SwiftUI view，都可以載入同解碼本地或遠端 JSON
🎛️ 可設定按鈕圓角 27.0 直接設定 buttonCornerRadius 或用 binding 控制，令版本說明觸發按鈕同主要操作按鈕嘅外觀保持一致
🔎 歷史搜尋控制 27.0 可以喺每個 SwiftNEW 實例啟用 Search，並按標題 / 副標題 / 內文篩選目前同歷史版本說明
📝 可選說明文字 27.0 showDescription 可直接設定或用 binding 控制，隱藏內文但保留圖示、標題同副標題
🌊 可重用 SwiftNEW 背景 27.0 SwiftNEWBackdrop 可以喺自訂 SwiftUI 內容後面重用靜態 / 流動網格背景同裝飾特效
🌐 更多語言 6.6.0 版本說明而家支援德文、希伯來文、印尼文、俄文同越南文
🌗 自適應圖示樣式 6.6.0 圖示背景同字形漸層會喺深色模式自動改善對比
🫧 著色玻璃控制項 6.6.0 版本說明同主要操作按鈕喺 iOS 26 使用原生互動式著色玻璃
🔄 替代 App 圖示 6.6.0 將標題圖示同已選擇嘅替代 App 圖示保持同步
🎨 智能 App 圖示深色模式 6.6.0 自動將大範圍白色或中性色圖案轉成深色，同時保留強調色
📱 自動載入 App 圖示 6.6.0 尋找並顯示最適合目前裝置嘅內置 App 圖示
⬆️ 遠端更新畫面 6.5.0 用 checkForUpdates 啟用；遠端 JSON 有較新版本時，顯示更新畫面同可自訂文字嘅 App Store 操作按鈕
🔁 動畫圖示循環 6.4.0 用原生 SF Symbol 替換過渡循環切換圖示
🧾 彈性圖示格式 6.4.0 可用 icon、toIcon 或完整 icons 陣列定義圖示
🎯 預設玻璃徽章 6.4.0 圓角玻璃圖示徽章令預設列樣式更柔和
🌈 漸層圖示字形 6.4.0 圖示 glyph 使用由左上至右下嘅主題漸層
🧩 列版面打磨 6.4.0 更大圖示、更緊湊列距同更圓操作按鈕
⬇️ 下移 Continue 控制 6.4.0 Continue 控制更貼近底部，操作更順手
🌊 流動網格動效 6.4.0 meshStyle:.still 或 .liquid 動畫網格背景
🏷️ 自訂標題前綴 6.4.0 用 headingPrefix 自訂版本上方標題行
🔍 內嵌搜尋 6.3.0 用標題 / 副標題 / 內文過濾當前版本說明
🏷️ 自訂標題 6.3.0 headingStyle:.version、.versionOnly、.appName
🔢 可選 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+)
Mesh visionOS
App 圖示 (3.9.6+) 歷史 (2.0+)
App Icon History

📝 備註

  • 將遠端 data URL 配合 checkForUpdates: true 傳入，就會啟用更新檢查。如果遠端最高嘅 subVersion（或者 version）高過目前安裝嘅 App 版本，SwiftNEW 會顯示更新畫面取代「最新功能」，並用 App 嘅 bundle identifier 經 Apple iTunes Lookup API 自動取得 App Store 目的地。主要操作預設顯示已本地化嘅 立即下載；用 updateButtonTitle 可以原樣顯示自訂文字。設定 allowsSkippingUpdate: false 就可以令更新畫面唔俾用戶略過。

📚 深入了解

文件 內容
Configuration 全部參數、例子、資料來源(本地 / 遠端 / Firebase)、資料模型
Platform Support & Installation 支援嘅 OS 版本、要求、功能對照表、SPM 設定
CarPlay Integration Template factory、scene lifecycle、資料載入、entitlement 要求
Contributing 專案結構、開發環境、PR 規範、疑難排解

📄 授權

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

詳情
✅ 可以 用喺商業 App(包括 App Store 收費 App)、改、再發佈,仲可以塞入閉源軟件
📝 必須 喺你個 project 入面保留原本嘅版權同授權聲明
⚠️ 無擔保 軟件按「現況」提供 — 作者唔會對使用而引起嘅問題負責

完整內容睇 LICENSE。

💖 贊助支持

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