开发指南Android开发指南.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)事件方法。@Overrideprotect 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对象。@Overrideprotect void onPause() {　super.onPause();　Mofang.onPause(this);　......}关于添加数据监测代码，有如下事项需要注意：* 确保应用中的每个Activity都添加了上述监测代码，以便魔方更准确地统计到用户