##总览 此文档介绍了如何使用Android Studio、Eclipse引入滴滴开放平台，并使用滴滴开放平台的相关服务。

##如何引入aar工程

###使用android studio ####引入 点击File->New�->New Module->import .jar/aar package，然后选择滴滴提供的aar包点击Finish即可。此时滴滴开放平台以Module的形式，需要手动配置Module的依赖关系（在使用滴滴服务Module的依赖中添加滴滴开放平台的Module）. ####配置DiDiWebActivity 滴滴开放平台的服务由DiDiWebActivity提供，一般情况下并不需要关心Mainfest文件中的声明。以下为Sdk中的声明：

		<activity
      		android:name=".DiDiWebActivity"
      		android:label="@string/title_activity_di_di_web" />

如果您需要指定其他配置可以直接在您的Mainfest文件中添加一个Activity声明。如下：

        <activity
            android:name="com.sdu.didi.openapi.DiDiWebActivity"
            android:launchMode="singleTop"
            android:screenOrientation="landscape"/>

声明了Activity的android:launchMode和android:screenOrientation，Android Studio会自动合并Mainfest文件。 ####如何更新aar包 在资源管理器中找到滴滴Module所在的文件夹，会看到旧版本的aar文件，直接使用新arr文件覆盖，然后点击工具栏中的Sync Project With Gradle File。

###使用eclipse ####引入 使用任意解压缩软件解压缩aar文件得到:

• classes.jar，sdk的jar包

将classes.jar文件改名为DiDiSdk.jar放入工程的libs文件夹

• jni ，需要放到libs的动态库文件

将jni里面的libdidi_secure.so放到。libs/armabi下

• res，资源文件

将res中的文件放入对应文件夹

• AndroidManifest.xml清单文件

将清单文件中的所有项复制到工程现有的清单文件中，并去重。

####配置DiDiWebActivity 同Android Studio ####如何更新aar包 同引入

##使用滴滴服务

注意 权限：由于Android 6.0系统以上引入了新的权限管理模型，所以如果你的应用targetSdkVersion>=23,在调用下面3.中所描述的openiapi时需要注意是否已经获取对了对应的权限，不然会发生crash,需要申请的权限有：

Manifest.permission.ACCESS_FINE_LOCATION
Manifest.permission.READ_PHONE_STATE
Manifest.permission.WRITE_EXTERNAL_STORAGE

定位：由于滴滴的服务依赖于定位，如果您没有主动传入定位信息则滴滴开放平台会自动定位，由于系统定位精度差定位速度慢，推荐您接入了第三方定位SDK. 如果您启用了混淆,请不要混淆定位sdk相关的代码。

在传入已有坐标时对应的maptype参数如下表：

定位厂商 | 地图类型 | ----|------|---- | 腾讯soso | soso | 高德 | soso | 百度 | bd09ll = baidu,默认坐标系为soso | 系统默认|wgs84|

需要传参数的的Map的key，value都为String,返回值都为Map的key，value都为String,在返回的Map中包含errorno和errormsg，其中errorno为判断返回是否成功的标志，返回0为成功，具体返回值的含义需要根据服务器接口对应文档获取。

1.在入口Activity中调用

DIOpenSDK.registerApp(context,"appid","secret")
其中appid和secret需要向开放平台申请
DIOpenSDK.setMapSdkType(DIOpenSDK.MapLocationType.*)(可选)

应在调用其他滴滴方法之前调用

2.直接调用打车业务

DIOpenSDK.showDDPage(Context,HashMap<String,String>);

Context参数尽量传Activity 其中HashMap为需要传给滴滴开放平台的参数

3.使用滴滴openapi直接调用滴滴接口

在申请appid和secret时，可以同时申请通过滴滴开放平台sdk直接调用滴滴服务器相应接口（需要经过商务协商）或者直接通过服务器和开放平台服务器直接对接。

服务器和服务器对接：

通过在主线程中调用DIOpenSDK.asynGetTicket(Context context, TicketType typeContext context, TicketType type, DDCallBack callBack)或者在分线程中调用DIOpenSDK.syncGetTicket()获取ticket，回传到第三方服务器用来服务器和服务器对接。

直接调用滴滴服务器API

通过在分线程中调用DIOpenSDK.syncCallDDApi(Context context, String apiname, Map<String, String> params)或者在主线程中调用DIOpenSDK.asynCallDDApi(Context context, String apiname, Map<String, String> requestParams, DDCallBack callBack) 即可调用滴滴服务器api具体可以调用的API列表需要跟商务确认。

直接调用滴滴功能页面

通过直接在主线程中调用DIOpenSDK.openPage(Context context,String page, Map<String, String> extra)即可打开滴滴提供的指定的功能性页面，比如登录、订单列表等，如果调用成功返回true调用失败返回false。

调用滴滴司机电话

当您调用滴滴相应功能获取到司机的加密手机号后需要使用DIOpenSDK.callPhone(Context context, String phone)来拨打司机电话。

##混淆 请在混淆的配置文件中增加以下配置

-keepnames class com.sdu.didi.openapi.utils.Utils{}
-keep public class com.sdu.didi.openapi.Methods{}
-keepnames class com.sdu.didi.openapi.location.*{*;}

-keepclassmembers class com.sdu.didi.openapi.Methods{
   public java.lang.String *(java.lang.String);
}

-keepclassmembers class com.sdu.didi.openapi.utils.Utils{
   public static java.lang.String getTimestamp();
   public static java.lang.String getRandomString(int);
}

-keep public class com.sdu.didi.uuid.ed {*;}
-keep public class com.sdu.didi.uuid.SigLib {*;}

##ReleaseNote 滴滴开放平台接入文档V1.1.0