开发指南 Adroid开发指南.docxVIP

开发指南 Android开发指南 使用魔方前请认真阅读本文档，避免不必要到麻烦。 1. 添加应用并获取SDK 登录进入魔方管理后台，点击“添加应用”进入应用创建流程页面。填写相关信息后应用创建成功，可在页面获取“AppKey”并点击“下载Android SDK”按钮下载SDK。 2. 使用基础数据统计功能 2.1 导入SDK 解压下载的SDK压缩包，并将其中的imofan.jar导入到工程中。以Eclipse为例，右键点击工程根目录，选择Properties Java Build Path Libraries，然后点击Add External JARs，找到解压出的imofan.jar文件，点击“打开”按钮即导入成功。 2.2 配置AndroidManifest.xml 要使用魔方基础数据统计功能，需要在AndroidManifest.xml中申明一些应用权限，并定义一些meta-data。示例如下： manifest ...... uses-permission android:name=android.permission.INTERNET/ uses-permission android:name=android.permission.READ_PHONE_STATE/ uses-permission android:name=android.permission.ACCESS_NETWORK_STATE/ uses-permission android:name=android.permission.ACCESS_WIFI_STATE / uses-permission android:name=android.permission.CHANGE_WIFI_STATE/ ...... application ...... meta-data android:name=MOFANG_APPKEY android:value=your_appkey/meta-data 　　meta-data android:name=MOFANG_CHANNEL android:value=your_channel/ 　　...... /application ...... /manifest 上述各属性释义如下： 应用权限 作用 INTERNET 允许应用访问互联网，发送统计数据 READ_PHONE_STATE 允许应用获取设备的device-id，便于构建设备的身份标识 ACCESS_NETWORK_STATE 允许应用检测网络连接状态，在网络异常状态下缓存数据暂不发送 ACCESS_WIFI_STATE 允许应用获取WiFi的MAC地址，便于为无法获取device-id的设备构建其身份标识 CHANGE_WIFI_STATE 允许应用检测网络连接状态，在网络异常状态下缓存数据暂不发送 魔方数据 作用 MOFANG_APPKEY 用来唯一标识应用的key，应用创建时由魔方系统自动生成 MOFANG_CHANNEL 应用推广渠道标识，可为不同渠道提供MOFANG_CHANNEL值不一样的APK安装包， 便于统计各渠道的推广效果。 (注意：渠道标识值英文字母和数字组成，最长24个字符，且必须包含至少一个英文字母)  2.3 添加数据监测代码 在需要调用魔方SDK的Activity类中引入com.imofan.android.basic.Mofang类。 import com.imofan.android.basic.Mofang; 在应用中每个Activity的onResume方法里调用Mofang.onResume(Activity context, String name)事件方法。 @Override protect void onResume() { 　　super.onResume(); 　　Mofang.onResume(this, 启动界面); 　　...... } 这里的传入参数context为当前Activity对象，name是为当前activity取的名字，便于访问路径分析时看起来更为直观。如果不需要为每个activity命名，则可直接调用Mofang.onResume(Activity context)事件方法，以类名表示activity的名字。 在对应的Activity的onPause方法里调用Mofang.onPause(Activity context)事件方法。这里的传入参数context为当前Activity对象。 @Override protect void onPause() { 　　super.onPause(); 　　Mofang.onP