iOS

Set up your adjoe App

Share the following information with your adjoe Account Manager:

• App bundle IDs

• App Store ID

Your Account Manager will share:

• SDKHash

• S2S Token

• API Token

Check minimum version

Minimum version to use the SDK's functionality: iOS 14.0

Add the Dependency

SPM (Native)

Cocoapods (Native)

Manually (Native)

The Swift Package Manager automates the distribution of Swift code. To use Playtime with SPM, add the dependency from https://github.com/adjoeio/adjoe-monetize-spm .

With Xcode

Go to File → Add Package Dependencies in the Menu Bar in Xcode. Search for `https://github.com/adjoeio/adjoe-monetize-spm and add it to your app's target.

Using Package.swift file

If your project uses Package.swift file, add Playtime as a dependency:

Copy

dependencies: [
  .package(url: "https://github.com/adjoeio/adjoe-monetize-spm", from: "4.2.0")
]

And then add the following product to any target that needs access to the library:

Copy

.product(name: "PlaytimeMonetize", package: "adjoe-monetize-spm")

Enable App Attest

1. Go to Apple Developer Certificates, IDs & Profiles

2. Select your app ID

3. Ensure App Attest is enabled under Capabilities

Add required capabilities

1. Select the project of your application in the Project Navigator

2. Select your target

3. Go to the tab Signing & Capabilities

4. Add the App Attest capability

Gather Credentials:

In order for adjoe's services to work with your app, the following credentials will need to be enabled for your app. They can be uploaded at the app-level in the Monetize Dashabord.

If you plan on using a dev and a prod environment, you will need to make sure distinct credentials are added for both app bundles, e.g., playtime.app.dev and playtime.app.

1. Private Key: Generate a private key that can be used for the AppAttest service and provide the file with the .p8 extension to adjoe. You can find the instruction on how to get the .p8 here. Only the DeviceCheck/AppAttest Service should be added.

1. Key ID: Generate a key identifier associated with the enabled service.

2. Team ID: Provide the Team ID, which app ID prefix: Team ID and the Bundle ID separated with a dot, for example: M4CAP9HPPJ.com.my.app. You can learn more about the app ID here.

Make sure that after you add the capability to your project, you can see the .entitlements file. Specify the production environment.

Upload Credentials

Add the Credentials under Edit Application in the Monetize Dashboard.

Locate your entitlements file

• When you add the App Attest capability, Xcode automatically creates a .entitlements file in your project (e.g., YourApp.entitlements)

• Find it in the Project Navigator

Set to production environment

• Open the .entitlements file

• Find the key: com.apple.developer.devicecheck.appattest-environment

• Set the value to production (NOT development)

Your entitlements file should look like this:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>com.apple.developer.associated-domains</key>
    <array>
        <string>webcredentials:prod.adjoe.zone</string>
    </array>
    <key>com.apple.developer.devicecheck.appattest-environment</key>
    <string>production</string>
</dict>
</plist>

Verify build configurations

• In Xcode, go to your Target → Build Settings

• Search for "Code Signing Entitlements"

• Ensure both Debug and Release configurations point to the same entitlements file with production set