InAppSettingsKit Documentation

If you are using InAppSettingsKit within a modularized Swift Package, you must include the InAppSettings.bundle as a resource and explicitly set the bundle property of the IASKAppSettingsViewController to Bundle.module.

// Package.swift configuration
let package = Package(
    name: "SettingsPackage",
    platforms: [.iOS(.v17)],
    dependencies: [
        .package(url: "https://github.com/futuretap/inappsettingskit", from: "3.4.0")
    ],
    .target(
        name: "SettingsPackage",
        dependencies: [
            .product(name: "InAppSettingsKit", package: "inappsettingskit"),
        ],
        resources: [
            .copy("InAppSettings.bundle")
        ]
    )
)

// Implementation in SwiftUI/UIKit
struct InAppSettingsView: UIViewControllerRepresentable {
    func makeUIViewController(context: Context) -> some UIViewController {
        let iask = IASKAppSettingsViewController(style: .insetGrouped)
        iask.bundle = Bundle.module // IMPORTANT
        return iask
    }

    func updateUIViewController(_ uiViewController: UIViewControllerType, context: Context) { }
}

Use IASKDatePickerSpecifier to display a UIDatePicker.

Configuration Options:

• DatePickerMode: Date, Time, or DateAndTime (Default: DateAndTime).
• DatePickerStyle: Compact, Wheels, or Inline (Default: Wheels). Requires iOS 14+; otherwise falls back to Wheels.
• MinuteInterval: The interval for minutes (Default: 1).

Customization via Delegate:

• -(NSDate*)settingsViewController:(IASKAppSettingsViewController*)sender dateForSpecifier:(IASKSpecifier*)specifier;: Use this if you store dates in a custom format. Called when the user selects the title cell.
• -(NSString*)settingsViewController:(IASKAppSettingsViewController*)sender datePickerTitleForSpecifier:(IASKSpecifier*)specifier;: Customize the displayed value in the title cell.
• -(void)settingsViewController:(IASKAppSettingsViewController*)sender setDate:(NSDate*)date forSpecifier:(IASKSpecifier*)specifier;: Called when the user changes the date/time value.

Use IASKAppSettingsWebViewController to display a fullscreen WKWebView inside your application. This keeps the URL private as it does not reveal the URL to the user or allow opening in external browsers like Safari.

In your Settings plist, use the following mandatory properties:

• Type: PSChildPaneSpecifier
• IASKViewControllerClass: IASKAppSettingsWebViewController
• IASKViewControllerSelector: initWithFile:specifier:
• Title: The localized title of the row.
• File: The URL to load (e.g., https://www.futuretap.com).

Optional customization properties:

• IASKWebViewFullscreen: Set to YES to extend content below the navigation bar.
• IASKWebViewShowProgress: Set to YES to show a dynamic progress bar below the navigation bar instead of the default activity indicator.
• IASKWebViewShowNavigationalButtons: Set to YES to show back/forward buttons in the navigation bar.
• IASKWebViewHideBottomBar: Set to YES to hide the tab bar when pushed onto a navigation controller (ignored if presented modally).

You can enhance the visual presentation of various specifiers using the following keys in your Plist:

Subtitles

Use IASKSubtitle for Toggle, ChildPane, OpenURL, MailCompose, and Button.

• Subtitles are left-aligned.
• Supports localizable Strings or a Dictionary. For boolean toggles, use YES and NO as keys. A __default__ key can be used for unmatched values.

Text Alignment

Override default alignment using IASKTextAlignment with these values:

• IASKUITextAlignmentLeft (ChildPane, TextField, Buttons, OpenURL, MailCompose)
• IASKUITextAlignmentCenter (ChildPane, Buttons, OpenURL)
• IASKUITextAlignmentRight (ChildPane, TextField, Buttons, OpenURL, MailCompose)

Font Size

To prevent labels from automatically shrinking to fit, add IASKAdjustsFontSizeToFitWidth with a value of NO.

Icons

Add an image using IASKCellImage.

• The suffix .png or @2x.png is automatically appended.
• For Buttons and ChildPanes, you can provide a highlight image by adding the Highlighted.png or Highlighted@2x.png suffix.
• If the resource is missing, the kit falls back to SF Symbols.