集成

在本页面中，您将了解到如何导入，配置 CartySDK。

基础配置

Xcode 26 或更高版本

iOS 13.0 或更高版本

集成SDK

Swift Package Manager

通过 Swift Package Manager 集成CartySDK，请按以下骤进行：

1.通过Xcode菜单打开配置界面（ File > Add Package Dependencies....）

2.在搜索框（Search or Enter Package URL）中，输入 CartySDK 的 Github.com 仓库地址：

https://github.com/cartysdk/Carty-swift-package-manager.git

3.选择您要使用的CartySDK版本,推荐使用 Up to Next Major Version 规则.

4.在 Other Linker Flags 中添加 -ObjC。具体位置：Xcode项目配置 TARGETS > Build Setting > Linking > Other Linker Flags 中添加

CocoaPods

通过 CocoaPods 集成CartySDK，请按以下骤进行：

1.在项目的Podfile中添加以下内容：

pod CartySDK

2.在终端中运行以下指令：

pod install --repo-update

初始化SDK

在 AppDelegate 的 application:applicationDidFinishLaunching: 方法调用如下代码并传入应用的 appid

• Objective-C

#import <CartySDK/CartySDK.h>

//调用初始化并传入appid
[[CartyADSDK sharedInstance] start:@"<your_app_id>" completion:^{
}];

• Swift

import CartySDK

//调用初始化并传入appid
CartyADSDK.sharedInstance().start("<your_app_id>") {
}

设置 UserID

如需向CartySDK传递UserID，可通过以下代码进行：

• Objective-C

[CartyADSDK sharedInstance].userid = @"<your-user-id>";

• Swift

CartyADSDK.sharedInstance().userid = "<your-user-id>"

IDFA获取授权

访问IDFA需要进行应用跟踪透明度授权, 首先需要在info.plist里添加NSUserTrackingUsageDescription键，内容为自定义的字符串，说明为什么要获取IDFA，可根据应用本身的需求决定是否对此字符串做国际化处理。:

<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>

配置内容会在应用跟踪透明度授权框内如图显示:

然后通过以下代码进行授权调用：

• Objective-C

if (@available(iOS 14, *))
{
    [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
    }];
}

• Swift

if #available(iOS 14, *) 
{
	ATTrackingManager.requestTrackingAuthorization(completionHandler: {status in
    })
}

更多说明可参考官方文档： ATTrackingManager.AuthorizationStatus.