iOS 快速入门

注册并登录 MaxLeap

首次登录会进入如下未创建过 App 页面

创建应用

自定义应用

用户自行创建工程项目并配置,根据具体业务设计数据库表结构和对应逻辑。

1、点击创建应用后,进入如下页面,输入应用名称并选择自定义应用,然后点击创建按钮 2、点击创建按钮后,应用创建成功,如果下图所示,可以应用相关密钥信息、移动端新手指南入口和我的应用列表入口

新项目集成

  1. 下载模板项目并解压

    请确保您使用的是最新的 Xcode (v7.0+), 并且目标平台版本为 iOS 7.0 或者更高。

    下载模板项目

  2. 配置项目

    在运行之前,还要进行一些配置:

    打开模板项目的 AppDelegate.m 文件,取消 application:didFinishLaunchingWithOptions: 中像下面这行的注释:

    [MaxLeap setApplicationId:@"your_application_id" clientKey:@"your_client_key" site:MLSiteCN];
    

    请把 your_application_idyour_client_key 替换成您自己应用的。最后一个参数 site 目前有两个值:MLSiteUS 对应 https://maxleap.com, MLSiteCN 对应 https://maxleap.cn。

  3. 现在可以运行了。

  4. 接下来测试配置是否正确

已有项目集成

使用 CocoaPods

CocoaPods 是一个很好用的依赖管理工具,可以简化安装过程。

在 Podfile 中添加:

# MaxLeap 核心 SDK
pod "MaxLeap/Core"

# 微信登录
pod "MaxLeap/WeChatUtils"

# 微博登录
pod "MaxLeap/WeiboUtils"

# QQ 登录
pod "MaxLeap/QQUtils"

# 支付
pod "MaxLeap/Pay"

# 应用内支付
pod "MaxLeap/Social"

然后再项目根目录执行 pod install 命令,就能将 MaxLeap SDK 集成到你的项目中。

手动安装

  1. 下载并解压缩 SDK

    请确认您使用的是Xcode最新版本(7.0+),目标平台为 iOS 7.0 或者更高版本。

    下载 SDK

  2. 添加 SDK 到您的应用

    将解压后文件夹中的 MaxLeap.framework 拖至Xcode项目目标文件夹下。确保已勾选“Copy items to destination’s group folder”的复选框。

    drag_sdk_to_project

  3. 添加依赖

    确保“Enable Modules (C and Objective-C)” 和 “Link Frameworks Automatically”的生成设置为Yes。

    enable_modules

    点击 Targets → YourAppName → “Build Phases” 栏。
    展开 “Link Binary With Libraries”,如下图:

    add_dependencies

    点击“Link Binary With Libraries”左下角+号按钮,添加下列框架:

    MobileCoreServices.framework
    CoreTelephony.framework
    SystemConfiguration.framework
    libsqlite3.dylib
    libz.dylib

连接云端应用

打开 AppDelegate.m 文件,并将如下import添加到文件顶部:

#import <MaxLeap/MaxLeap.h>

然后将以下代码复制到 application:didFinishLaunchingWithOptions: 方法中:

[MaxLeap setApplicationId:@"your_application_id" clientKey:@"your_client_id" site:MLSiteCN];

请把 your_application_idyour_client_id 替换成您自己的 MaxLeap 应用的。最后一个参数 site 目前有两个值:MLSiteUS 对应 https://maxleap.com, MLSiteCN 对应 https://maxleap.cn。

编译并运行!

测试是否可以连接到 MaxLeap 服务器

为了检测是否可以连接 MaxLeap 云服务和目标应用,我们可以在 appDelegate.mapplication:didFinishLaunchingWithOptions: 方法中加入以下代码:

#import <MaxLeap/MaxLeap.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    [MaxLeap setApplicationId:@"your_application_id" clientKey:@"your_client_key" site:MLSiteCN];

    MLObject *obj = [MLObject objectWithoutDataWithClassName:@"Test" objectId:@"561c83c0226"];
    [obj fetchIfNeededInBackgroundWithBlock:^(MLObject * _Nullable object, NSError * _Nullable error) {
        if (error.code == kMLErrorInvalidObjectId) {
            NSLog(@"已经能够正确连接上您的云端应用");
        } else {
            NSLog(@"应用访问凭证不正确,请检查。");
        }
    }];
}

运行您的应用。然后查看 Xcode console 中打印的日志。

下一步

至此,您已经完成MaxLeap SDK的安装与必要的配置。请移步至 iOS SDK开用指南以获取MaxLeap的详细功能介绍以及使用方法,开启MaxLeap云服务使用之旅。