/aepsdk-analytics-ios-1

Primary LanguageSwiftApache License 2.0Apache-2.0

Adobe Experience Platform Analytics SDK

Cocoapods SPM CircleCI Code Coverage

About this project

The AEPAnalytics extension represents the Analytics Adobe Experience Platform SDK that is required for sending mobile interaction data from your app to Adobe Analytics.

Requirements

  • Xcode 11.x
  • Swift 5.x

Installation

These are currently the supported installation options:

CocoaPods

# Podfile
use_frameworks!

# For app development, include all the following pods
target 'YOUR_TARGET_NAME' do
    pod 'AEPAnalytics'
    pod 'AEPCore'
    pod 'AEPIdentity'
end

# For extension development, include AEPAnalytics and its dependencies
target 'YOUR_TARGET_NAME' do
    pod 'AEPAnalytics'
    pod 'AEPCore'
end

Replace YOUR_TARGET_NAME and then, in the Podfile directory, type:

$ pod install

Swift Package Manager

To add the AEPAnalytics Package to your application, from the Xcode menu select:

File > Swift Packages > Add Package Dependency...

Enter the URL for the AEPAnalytics package repository: https://github.com/adobe/aepsdk-analytics-ios.git.

When prompted, make sure you change the branch to main. (Once the repo is public, we will reference specific tags/versions instead of a branch)

There are three options for selecting your dependencies as identified by the suffix of the library name:

  • "Dynamic" - the library will be linked dynamically
  • "Static" - the library will be linked statically
  • (none) - (default) SPM will determine whether the library will be linked dynamically or statically

Alternatively, if your project has a Package.swift file, you can add AEPAnalytics directly to your dependencies:

dependencies: [
    .package(url: "https://github.com/adobe/aepsdk-analytics-ios.git", .branch("main"))
]

Project Reference

Include AEPAnalytics.xcodeproj in the targeted Xcode project and link all necessary libraries to your app target.

Binaries

Run make archive from the root directory to generate .xcframeworks for each module under the build folder. Drag and drop all .xcframeworks to your app target in Xcode.

Documentation

Additional documentation for usage and SDK architecture can be found under the Documentation directory.

Contributing

Contributions are welcomed! Read the Contributing Guide for more information.

Licensing

This project is licensed under the Apache V2 License. See LICENSE for more information.