滴滴试驾开放服务SDK

SDK接入准备

第三方APP在接入SDK时需要提前准备好appId和appSecret,其中appSecret用于签名; 点击获得appId和appSecret

开发环境

• iOS7+ Xcode7+

如何接入SDK

• 已使用cocoapods管理工程的项目

• podfile文件中加入pod "DNTryDriveOpenSDK", :git => "https://github.com/diditaxi/DNTryDriveOpenSDK.git" 终端进入工程所在目录下，执行pod install命令，执行完成后工程就具备DNTryDriveOpenSDK的能力

• 未使用cocoapods管理工程的项目

• 手动把静态库（.a）以及头文件拷贝到工程中，在项目中添加SSKeychain和WebViewJavascriptBridge第三方库依赖

代码接入

• 添加需要的编译选项

• 在TARGETS-Build Settings-Other Linker Flags中添加如下内容：-ObjC

• 在iOS9中支持http请求

• 在XXXX-Info.plist中添加NSAppTransportSecurity类型为Dictionary，在NSAppTransportSecurity下添加NSAllowsArbitraryLoads类型为Boolean，值为YES。

• 在iOS8以上的系统中支持定位

• 在XXXX-Info.plist中添加NSLocationWhenInUseUsageDescription类型为String，值可为空。

• 在AppDelegate中以以下方式引入头文件

#import <DNTryDriveOpenSDK/DNTryDriveOpenSDK.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{
    // 设置appId和appSecret
    [DNOpenSDKManager setAppId:@"33837971c4294a939f4d14d61a282fe5" withAppSecret:@"OtxrzxIsfpFjA7SwPzILwy8Bw21TLhquhboDYROV"];
    ....
    
    return YES;
}

• 使用SDK提供的Controller和WebView

#import <DNTryDriveOpenSDK/DNTryDriveOpenSDK.h>
// 继承自SDK提供的DNWebViewController即可，已注册WebView与JS的交互handler
@interface DNContentViewController : DNWebViewController
    
@end

@implementation DNContentViewController

- (void)viewDidLoad{
    [super viewDidLoad];
    
    ...

    // 发请求，实际接入时需要使用真是的位置信息和真实的车型id
    CLLocationCoordinate2D coordinate = CLLocationCoordinate2DMake(40.042643, 116.290847);
    [self loadRequestWithCarModelId:@"662" currentCoordinate:coordinate];
}

@end

• 使用自己的Controller和WebView

#import <DNTryDriveOpenSDK/DNTryDriveOpenSDK.h>

- (void)viewDidLoad {
    [super viewDidLoad];

    self.title = @"滴滴试驾";

    // 调用如下方法注册WebView与JS的交互handler，此方法会生成一个默认的jsBridge
    // 给webView设置自己的jsBridge，并注册WebView与JS的交互handler，如果使用SDK默认的jsBridge，此行代码可以注释掉，改用[self.webView loadDefaultJavascriptBridge];
    // self.webView.javascriptBridge = xxxx; // xxxx表示自己的jsBridge
    
    // 注册WebView与JS的交互handler，如果没有设置自己的jsBridge，此方法会创建一个默认的jsBridge，如果设置了自己的jsBridge，则调用此方法，什么事情都不会发生
    [self.webView loadDefaultJavascriptBridge];
    
    // 车型id
    NSString *carModelId = @"622";
    // 当前位置的经纬度信息
    CLLocationCoordinate2D currentCoordinate = CLLocationCoordinate2DMake(40.042643, 116.290847);
    // 得到预约发单页面的url
    NSString *url = DNOpenSDKTryDriveWebViewMakeOrderURL(carModelId, currentCoordinate);
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:url] cachePolicy:NSURLRequestReloadIgnoringCacheData timeoutInterval:10.0];
    // 加载请求
    [self.webView loadRequest:request];

    ...

}

License

DNTryDriveOpenSDK is available under the MIT license. See the LICENSE file for more info.