WhatsNewKit下載 - WhatsNewKit源代碼下載

import SwiftUI
import WhatsNewKit

struct ContentView : View {

    var body : some View {
        NavigationView {
            // ...
        }
        . whatsNewSheet ( )
    }

}

特徵

輕鬆介紹您的新應用功能？
自動和手動演示模式✅
支持Swiftui，Uikit和AppKit？ ‍？
在iOS，macos和visionos上運行？？
可調節佈局？

安裝

Swift軟件包管理器

要使用Apple的Swift軟件包管理器集成，請添加以下作為依賴性的Package.swift ：Swift：

dependencies: [
    . package ( url : " https://github.com/SvenTiigi/WhatsNewKit.git " , from : " 2.0.0 " )
]

或導航到您的Xcode項目，然後選擇Swift Packages ，單擊“+”圖標，然後搜索WhatsNewKit 。

例子

查看示例應用程序，以查看WhatsNewKit正在行動。只需打開Example/Example.xcodeproj並運行“示例”方案。

示例應用程序

用法

手動演示

如果您想手動展示WhatsNewView則可以使用sheet(whatsNew:)修改器。

 struct ContentView : View {

    @ State
    var whatsNew : WhatsNew ? = WhatsNew (
        title : " WhatsNewKit " ,
        features : [
            . init (
                image : . init (
                    systemName : " star.fill " ,
                    foregroundColor : . orange
                ) ,
                title : " Showcase your new App Features " ,
                subtitle : " Present your new app features... "
            ) ,
            // ...
        ]
    )

    var body : some View {
        NavigationView {
            // ...
        }
        . sheet (
            whatsNew : self . $whatsNew
        )
    }

}

自動演示

自動演示模式使您可以簡單地通過SwiftUI環境聲明您的新功能，WhatsNewKit將注意相應的WhatsNewView 。

首先將.whatsNewSheet()修飾符添加到應在其中顯示WhatsNewView視圖中。

 struct ContentView : View {

    var body : some View {
        NavigationView {
            // ...
        }
        // Automatically present a WhatsNewView, if needed.
        // The WhatsNew that should be presented to the user
        // is automatically retrieved from the `WhatsNewEnvironment`
        . whatsNewSheet ( )
    }

}

.whatsNewSheet()修飾符正在利用WhatsNewEnvironment檢索應向當前版本呈現用戶提供的可選WhatsNew對象。因此，您可以通過environment修飾符輕鬆地配置WhatsNewEnvironment 。

 extension App : SwiftUI . App {

    var body : some Scene {
        WindowGroup {
            ContentView ( )
                . environment (
                     . whatsNew ,
                    WhatsNewEnvironment (
                        // Specify in which way the presented WhatsNew Versions are stored.
                        // In default the `UserDefaultsWhatsNewVersionStore` is used.
                        versionStore : UserDefaultsWhatsNewVersionStore ( ) ,
                        // Pass a `WhatsNewCollectionProvider` or an array of WhatsNew instances
                        whatsNewCollection : self
                    )
                )
        }
    }

}

// MARK: - App+WhatsNewCollectionProvider

extension App : WhatsNewCollectionProvider {

    /// Declare your WhatsNew instances per version
    var whatsNewCollection : WhatsNewCollection {
        WhatsNew (
            version : " 1.0.0 " ,
            // ...
        )
        WhatsNew (
            version : " 1.1.0 " ,
            // ...
        )
        WhatsNew (
            version : " 1.2.0 " ,
            // ...
        )
    }

}

WhatsNewenvironment

WhatsNewEnvironment將注意確定應向當前版本提供給用戶的匹配WhatsNew對象。

如上一個示例所示，您可以通過指定WhatsNewVersionStore並提供WhatsNewCollection來初始化WhatsNewEnvironment 。

// Initialize WhatsNewEnvironment by passing an array of WhatsNew Instances.
// UserDefaultsWhatsNewVersionStore is used as default WhatsNewVersionStore
let whatsNewEnvironment = WhatsNewEnvironment (
    whatsNewCollection : [
        WhatsNew (
            version : " 1.0.0 " ,
            // ...
        )
    ]
)

// Initialize WhatsNewEnvironment with NSUbiquitousKeyValueWhatsNewVersionStore
// which stores the presented versions in iCloud.
// WhatsNewCollection is provided by a `WhatsNewBuilder` closure
let whatsNewEnvironment = WhatsNewEnvironment (
    versionStore : NSUbiquitousKeyValueWhatsNewVersionStore ( ) ,
    whatsNewCollection : {
        WhatsNew (
            version : " 1.0.0 " ,
            // ...
        )
    }
)

此外， WhatsNewEnvironment還包括補丁版本的後備。例如，當用戶安裝版本1.0.1並且您僅聲明了版本1.0.0的WhatsNew時，環境將自動退回到1.0.0版，並在需要時向用戶呈現WhatsNewView 。

如果您希望進一步自定義WhatsNewEnvironment的行為，則可以輕鬆地子類並覆蓋whatsNew()函數。

 class MyCustomWhatsNewEnvironment : WhatsNewEnvironment {

    /// Retrieve a WhatsNew that should be presented to the user, if available.
    override func whatsNew ( ) -> WhatsNew ? {
        // The current version
        let currentVersion = self . currentVersion
        // Your declared WhatsNew objects
        let whatsNewCollection = self . whatsNewCollection
        // The WhatsNewVersionStore used to determine the already presented versions
        let versionStore = self . whatsNewVersionStore
        // TODO: Determine WhatsNew that should be presented to the user...
    }

}

WhatsNewversionstore

WhatsNewVersionStore是一種協議類型，負責保存和檢索已呈現給用戶的版本。

 let whatsNewVersionStore : WhatsNewVersionStore

// Save presented versions
whatsNewVersionStore . save ( presentedVersion : " 1.0.0 " )

// Retrieve presented versions
let presentedVersions = whatsNewVersionStore . presentedVersions

// Retrieve bool value if a given version has already been presented
let hasPresented = whatsNewVersionStore . hasPresented ( " 1.0.0 " )

WhatsNewkit隨附了三個預定義的實現：

// Persists presented versions in the UserDefaults
let userDefaultsWhatsNewVersionStore = UserDefaultsWhatsNewVersionStore ( )

// Persists presented versions in iCloud using the NSUbiquitousKeyValueStore
let ubiquitousKeyValueWhatsNewVersionStore = NSUbiquitousKeyValueWhatsNewVersionStore ( )

// Stores presented versions in memory. Perfect for testing purposes
let inMemoryWhatsNewVersionStore = InMemoryWhatsNewVersionStore ( )

如果您已經具有特定的實現來存儲與用戶相關的設置（例如領域或核心數據），則可以輕鬆地將現有的實現採用到WhatsNewVersionStore協議。

nsubipiquitousKeyvalueWhatsNewversionStore

如果要使用NSUbiquitousKeyValueWhatsNewVersionStore ，請確保在Xcode項目的“簽名和功能”部分中啟用iCloud鍵值存儲功能。

iCloud鍵值存儲

什麼是新的

以下各節解釋瞭如何將WhatsNew結構進行初始化，以描述您應用程序的給定版本的新功能。

 let whatsnew = WhatsNew (
    // The Version that relates to the features you want to showcase
    version : " 1.0.0 " ,
    // The title that is shown at the top
    title : " What's New " ,
    // The features you want to showcase
    features : [
        WhatsNew . Feature (
            image : . init ( systemName : " star.fill " ) ,
            title : " Title " ,
            subtitle : " Subtitle "
        )
    ] ,
    // The primary action that is used to dismiss the WhatsNewView
    primaryAction : WhatsNew . PrimaryAction (
        title : " Continue " ,
        backgroundColor : . accentColor ,
        foregroundColor : . white ,
        hapticFeedback : . notification ( . success ) ,
        onDismiss : {
            print ( " WhatsNewView has been dismissed " )
        }
    ) ,
    // The optional secondary action that is displayed above the primary action
    secondaryAction : WhatsNew . SecondaryAction (
        title : " Learn more " ,
        foregroundColor : . accentColor ,
        hapticFeedback : . selection ,
        action : . openURL (
            . init ( string : " https://github.com/SvenTiigi/WhatsNewKit " )
        )
    )
)

whatsnew.version

WhatsNew.Version指定了為您的應用程序引入某些功能的版本。

// Initialize with major, minor, and patch
let version = WhatsNew . Version (
    major : 1 ,
    minor : 0 ,
    patch : 0
)

// Initialize by string literal
let version : WhatsNew . Version = " 1.0.0 "

// Initialize WhatsNew Version by using the current version of your bundle
let version : WhatsNew . Version = . current ( )

whatsnew.title

WhatsNew.Title表示功能上方呈現的標題文本。

// Initialize by string literal
let title : WhatsNew . Title = " Continue "

// Initialize with text and foreground color
let title = WhatsNew . Title (
    text : " Continue " ,
    foregroundColor : . primary
)

// On >= iOS 15 initialize with AttributedString using Markdown
let title = WhatsNew . Title (
    text : try AttributedString (
        markdown : " What's **New** "
    )
)

whatsnew.feature

WhatsNew.Feature描述了您的應用程序的特定功能，通常由圖像，標題和字幕組成。

 let feature = WhatsNew . Feature (
    image : . init (
        systemName : " wand.and.stars "
    ) ,
    title : " New Design " ,
    subtitle : . init (
        try AttributedString (
            markdown : " An awesome new _Design_ "
        )
    )
)

WhatsNew.PrimaryAction

WhatsNew.PrimaryAction允許您配置用於刪除介紹的WhatsNewView主按鈕的行為

 let primaryAction = WhatsNew . PrimaryAction (
    title : " Continue " ,
    backgroundColor : . blue ,
    foregroundColor : . white ,
    hapticFeedback : . notification ( . success ) ,
    onDismiss : {
        print ( " WhatsNewView has been dismissed " )
    }
)

注意：HapticFeedback僅在iOS上執行

whatsnew.sparyaction

WhatsNew.SecondaryAction顯示在WhatsNew.PrimaryAction上方顯示。初始化WhatsNew實例時，可以選擇提供原始ActionAction，並允許您提供其他視圖，執行自定義操作或打開URL。

// SecondaryAction that presents a View
let secondaryActionPresentAboutView = WhatsNew . SecondaryAction (
    title : " Learn more " ,
    foregroundColor : . blue ,
    hapticFeedback : . selection ,
    action : . present {
        AboutView ( )
    }
)

// SecondaryAction that opens a URL
let secondaryActionOpenURL = WhatsNew . SecondaryAction (
    title : " Read more " ,
    foregroundColor : . blue ,
    hapticFeedback : . selection ,
    action : . open (
        url : . init ( string : " https://github.com/SvenTiigi/WhatsNewKit " )
    )
)

// SecondaryAction with custom execution
let secondaryActionCustom = WhatsNew . SecondaryAction (
    title : " Custom " ,
    action : . custom { presentationMode in
        // ...
    }
)

注意：HapticFeedback僅在iOS上執行

佈局

WhatsNewKit允許您以各種方式調整呈現的WhatsNewView的佈局。

最簡單的方法是突變WhatsNew.Layout.default實例。

 WhatsNew . Layout . default . featureListSpacing = 35

使用自動演示樣式時，您可以在初始化WhatsNewenvironment時提供默認佈局。

 . environment (
     . whatsNew ,
    . init (
        defaultLayout : WhatsNew . Layout (
            showsScrollViewIndicators : true ,
            featureListSpacing : 35
        ) ,
        whatsNew : self
    )
)

另外，您可以通過WhatsNew.Layout自動或手動顯示WhatsNewView

 . whatsNewSheet (
    layout : WhatsNew . Layout (
        contentPadding : . init (
            top : 80 ,
            leading : 0 ,
            bottom : 0 ,
            trailing : 0
        )
    )
)

 . sheet (
    whatsNew : self . $whatsNew ,
    layout : WhatsNew . Layout (
        footerActionSpacing : 20
    )
)

WhatsNewViewController

使用UIKit或AppKit時，您可以使用WhatsNewViewController 。

 let whatsNewViewController = WhatsNewViewController (
    whatsNew : WhatsNew (
        version : " 1.0.0 " ,
        // ...
    ) ,
    layout : WhatsNew . Layout (
        contentSpacing : 80
    )
)

如果您只想在尚未提出WhatsNew實例的版本時才提出WhatsNewViewController ，則可以使用便利性故障初始化器。

// Verify WhatsNewViewController is available for presentation
guard let whatsNewViewController = WhatsNewViewController (
    whatsNew : WhatsNew (
        version : " 1.0.0 " ,
        // ...
    ) ,
    versionStore : UserDefaultsWhatsNewVersionStore ( )
) else {
    // Version of WhatsNew has already been presented
    return
}

// Present WhatsNewViewController
// Version will be automatically saved in the provided
// WhatsNewVersionStore when the WhatsNewViewController gets dismissed
self . present ( whatsNewViewController , animated : true )

展開

WhatsNewKit

特徵

安裝

Swift軟件包管理器

例子

用法

目錄

手動演示

自動演示

WhatsNewenvironment

WhatsNewversionstore

nsubipiquitousKeyvalueWhatsNewversionStore

什麼是新的

whatsnew.version

whatsnew.title

whatsnew.feature

WhatsNew.PrimaryAction

whatsnew.sparyaction

佈局

WhatsNewViewController

Google Dorks

shepherd

mongo express

hidusbf

Free Algorithms Books

markdownpedia

chat.petals.dev

GPT Prompt Templates

GPTyped

Google Dorks

shepherd

mongo express

Google Dorks

shepherd

mongo express