Appaloosa SDK

概述

Appaloosa SDK 库是一个简单的库，可以帮助您

• 自动更新存储在 Appaloosa Store 服务器上的您的应用程序
• 管理您的应用程序的授权
• 防止您的应用程序在越狱设备上运行

要求

Appaloosa SDK 库使用 ARC，并且兼容 iOS 8 及以上版本。

/!\ 为了完成“自动更新”和“黑名单”功能的设置，设备必须在原生商店中进行至少一次成功的登录，以将设备的 ADID 注册到服务器上。/!\ 您的应用程序 ID 必须是明确的（而不是通配符形式的）/!\ 在模拟器上的测试将不会工作

集成

手动

• 下载并导入 OTAppaloosa 源文件
• 将 OTAppaloosa 源文件添加到您的项目中。

配置 Appaloosa 代理

一旦 Appaloosa SDK 集成到您的项目中，您需要使用 storeId 和 storeToken 配置代理。

• 使用您的 storeId 和 storeToken 注册 Appaloosa 代理（您可以在本页面找到 storeId 和 storeToken：[http://www.appaloosa-store.com/settings]http://www.appaloosa-store.com/settings）。

• 在您的 AppDelegate:applicationDidBecomeActive() 中添加注册 Appaloosa 代理。

objective-c

[[OTAppaloosaAgent sharedAgent] registerWithStoreId:APPALOOSA_STORE_ID storeToken:APPALOOSA_STORE_TOKEN
andDelegate:self];

swift

OTAppaloosaAgent.shared().register(
withStoreId: APPALOOSA_STORE_ID,
storeToken: APPALOOSA_STORE_TOKEN)

检查应用程序更新 - 简单版本

objective-c

1. 在您的 AppDelegate.m 文件中，当您的应用程序启动时启动自动更新
2. 导入插件：#import "OTAppaloosa.h"
3. 使用 StoreId 和 StoreToken 注册 Appaloosa 代理
4. 在方法 - (void)applicationDidBecomeActive:(UIApplication *)application 中，添加以下代码行

[[OTAppaloosaAgent sharedAgent] checkUpdates];

Swift

1. 在您的 AppDelegate.swift 文件中，当应用程序启动时启动自动更新
2. 导入插件：import OTAppaloosa
3. 使用 StoreId 和 StoreToken 注册 Appaloosa 代理
4. 在方法 AppDelegate:applicationDidBecomeActive() 中，添加以下代码行

OTAppaloosaAgent.shared().checkUpdates()

检查应用程序更新 - 高明版本

Objective-C

1. 在您的 AppDelegate.h 文件中
2. 导入插件：#import "OTAppaloosa.h"
3. 将 OTAppaloosaAgentDelegate 添加到您的接口中

@interface AppDelegate : UIResponder <UIApplicationDelegate, OTAppaloosaAgentDelegate>

2. 在您的 AppDelegate.m 文件中，当应用程序启动时启动自动更新
3. 注册 Appaloosa Agent（storeId + storeToken）
4. 在方法 - (void)applicationDidBecomeActive:(UIApplication *)application 中，添加以下代码行

[[OTAppaloosaAgent sharedAgent] checkUpdates];

3. 实现代理方法以自定义行为
4. 方法 - (void)applicationUpdateRequestSuccessWithApplicationUpdateStatus:(OTAppaloosaUpdateStatus)appUpdateStatus 通知应用程序需要更新。您需要分析 'appUpdateStatus' 以确定是否可用新版本，并下载新版本。默认情况下，

• 如果应用程序是最新的，则不执行任何操作。
• 如果可用更新，则弹出一个警告视图请求用户下载。如果您想要启动下载：[[OTAppaloosaAgent sharedAgent] downloadNewVersion];

2. 方法 - (void)applicationUpdateRequestFailureWithError:(NSError *)error 用来通知更新请求期间是否发生错误。

Swift

1. 在您的 AppDelegate.swift 文件中
2. 导入插件：import OTAppaloosa
3. 将 OTAppaloosaAgentDelegate 添加到您的接口中

class AppDelegate: UIResponder, UIApplicationDelegate, OTAppaloosaAgentDelegate

2. 在您的 AppDelegate.swift 文件中，当应用程序启动时启动自动更新
3. 注册 Appaloosa Agent（storeId + storeToken）
4. 在方法 AppDelegate:applicationDidBecomeActive() 中，添加以下代码行

OTAppaloosaAgent.shared().register(
withStoreId: APPALOOSA_STORE_ID,
storeToken: APPALOOSA_STORE_TOKEN, andDelegate: self)
OTAppaloosaAgent.shared().checkUpdates()

3. 实现代理方法以自定义行为
4. 方法 - func applicationUpdateRequestSuccess(withApplicationUpdateStatus appUpdateStatus: OTAppaloosaUpdateStatus) 用于通知应用程序需要更新。您需要分析 'appUpdateStatus' 以确定是否可用新版本并下载新版本。默认情况下，

• 如果应用程序是最新的，则不执行任何操作。
• 如果可用更新，则显示一个警告视图请求用户下载。如果您想要启动下载：OTAppaloosaAgent.shared().downloadNewVersion()

检查应用程序权限

此 SDK 提供了一个“关闭开关”机制。从 Web 界面（http://www.appaloosa-store.com/），您可以选择授权或不授权设备访问应用程序。该机制通过从密钥链中读取黑名单状态在离线状态下工作。

在您的 appDelegate 中添加以下行以在应用程序变为激活状态时检查权限 - (void)applicationDidBecomeActive:(UIApplication *)application

Objective-C

[[OTAppaloosaAgent sharedAgent] checkAuthorizations];

Swift

OTAppaloosaAgent.shared().checkAuthorizations()

默认情况下

• 如果用户已被授权，则不执行任何操作。
• 如果用户未被授权，则显示带有适当消息的警告视图，并终止应用程序。

如果您更喜欢开发自己的行为，您应实现 OTAppaloosaAgentDelegate

• 以判断用户是否已被授权：- (void)applicationAuthorizationsAllowed;
• 以判断用户是否未被授权：- (void)applicationAuthorizationsNotAllowedWithStatus:(OTAppaloosaAutorizationsStatus)status andMessage:(NSString *)message

检查设备是否越狱

您可以通过以下方式防止应用程序在越狱设备上运行。

在您的appDelegate文件中，添加以下行以在应用程序变为活动状态时检查权限：- (void)applicationDidBecomeActive:(UIApplication *)application

Objective-C

[[OTAppaloosaAgent sharedAgent] blockJailbrokenDevice];

Swift

OTAppaloosaAgent.shared().blockJailbrokenDevice()

需要文档吗？

Appaloosa SDK for iOS使用AppleDoc来生成其API文档。

许可证

版权（C）2012 Appaloosa（《https://www.appaloosa-store.com》

根据Apache License，版本2.0（“许可证”）进行许可；除非遵守许可证，否则不得使用此文件。您可以在以下位置获取许可证副本：

https://apache.ac.cn/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则在许可证下分发的软件按“原样”分发，不提供任何明示或暗示的保证或条件。有关许可证的具体语言、权限和限制，请参阅许可证。