Add Appcues device mode support to your applications via this plugin for Analytics-Swift
Note: the Appcues library itself will be installed as an additional dependency. An installation tutorial video is also available, for reference.
In the Xcode File menu, click Add Packages. You'll see a dialog where you can search for Swift packages. In the search field, enter the URL to this repo.
https://github.com/appcues/segment-appcues-ios
You'll then have the option to pin to a version, or specific branch, as well as which project in your workspace to add it to. Once you've made your selections, click the Add Package button.
Open your Package.swift file and add the following do your the dependencies section:
.package(
url: "https://github.com/appcues/segment-appcues-ios.git",
from: "3.0.0"
),
Open the file where you setup and configure the Analytics-Swift library. Add this plugin to the list of imports.
import Segment
import SegmentAppcues // <-- Add this line
Just under your Analytics-Swift library setup, call analytics.add(plugin: ...) to add an instance of the plugin to the Analytics timeline.
let analytics = Analytics(configuration: Configuration(writeKey: "<YOUR WRITE KEY>")
.flushAt(3)
.trackApplicationLifecycleEvents(true))
analytics.add(plugin: AppcuesDestination())
Your events will now begin to flow to Appcues in device mode.
During installation, follow the steps outlined in in the Appcues iOS SDK documentation for Configuring the Appcues URL Scheme. This is necessary for the complete Appcues builder experience, supporting experience preview, screen capture and debugging.
Please use Github issues, Pull Requests, or feel free to reach out to our support team.