Installation

iOS

Manual Installation

1. Drag SashaSDK.xcframework directly into your Xcode project.
2. Make sure it's added under your target's Frameworks, Libraries, and Embedded Content.

Add Local Swift Package

As per now, we don't support Swift Package Manager. However, you can support this by using a local package in your project.

If you prefer to include the SDK directly in your own repository:

1. Create a new folder in your project, for example:

   mkdir -p ThirdParty/SashaSDK

2. Place SashaSDK.xcframework inside that folder.

3. In the same folder, create a file named Package.swift with the following content:

// swift-tools-version: 6.0
import PackageDescription

let package = Package(
    name: "SashaSDK",
    platforms: [
        .iOS(.v15)
    ],
    products: [
        .library(
            name: "SashaSDK",
            targets: ["SashaSDK"]
        )
    ],
    targets: [
        .binaryTarget(
            name: "SashaSDK",
            path: "SashaSDK.xcframework"
        )
    ]
)

4. In Xcode, go to File → Add Packages… → Add Local…
5. Select the folder you just created (ThirdParty/SashaSDK).
6. Add SashaSDK to your target.

Using this method allows you to manage SashaSDK via Swift Package Manager locally, even though the SDK itself doesn't officially support SPM.

Android

To integrate the Sasha SDK into your project, follow these steps:

1. Add the source files to your project:

   • Create a libs directory in your app module (e.g., YourAppProject/app/libs/).

   • Copy the contents of the provided .zip-folder containing the sources for the Sasha SDK and paste them into the "app/libs" folder you created in the step above

   • You should end up with the following hierarchy:

     YourAppProject/
     └── app/
         └── libs/
             └── eu/
                 └── sasha/
                     └── sasha-sdk/
                         └── {latest_version}/
                             ├── sasha-sdk-{latest_version}.aar
                             ├── sasha-sdk-{latest_version}.pom
                             ├── sasha-sdk-{latest_version}-javadoc.jar

2. Configure your project's settings.gradle.kts:

   • Open your project's settings.gradle.kts file.
   • Add a maven block to the repositories section, pointing to your app/libs directory, where the Sasha SDK is now located. This should be added within the dependencyResolutionManagement block, which should then look like the following:

     dependencyResolutionManagement {
         repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
         repositories {
             google()
             mavenCentral()
     
             // Add this block to declare your local Maven repository
             maven {
                 url = uri("app/libs")
             }
         }
     }

3. Add the SDK dependency: Open your app-level build.gradle.kts file and add the following to your dependencies block:

   implementation("eu.sasha:sasha-sdk:{latest_version}")