《开发指南android开发指南》由会员分享，可在线阅读，更多相关《开发指南android开发指南（7页珍藏版）》请在金锄头文库上搜索。
1、开发指南 Android 开发指南使用魔方前请认真阅读本文档，避免不必要到麻烦。1. 添加应用并获取 SDK登录进入魔方管理后台，点击“添加应用”进入应用创建流程页面。填写相关信息后应用创建成功，可在页面获取“AppKey”并点击“下载 Android SDK”按钮下载SDK。2. 使用基础数据统计功能2.1 导入 SDK解压下载的 SDK 压缩包，并将其中的 imofan.jar 导入到工程中。以 Eclipse 为例，右键点击工程根目录，选择 Properties Java Build Path Libraries，然后点击 Add External JARs，找到解压出的 imofan.
2、jar 文件，点击“打开”按钮即导入成功。2.2 配置 AndroidManifest.xml要使用魔方基础数据统计功能，需要在 AndroidManifest.xml 中申明一些应用权限，并定义一些meta-data。示例如下：.上述各属性释义如下：应用权限 作用INTERNET 允许应用访问互联网，发送统计数据READ_PHONE_STATE 允许应用获取设备的 device-id，便于构建设备的身份标识ACCESS_NETWORK_STATE 允许应用检测网络连接状态，在网络异常状态下缓存数据暂不发送应用权限 作用ACCESS_WIFI_STATE 允许应用获取 WiFi 的 MAC 地
3、址，便于为无法获取 device-id 的设备构建其身份标识CHANGE_WIFI_STATE 允许应用检测网络连接状态，在网络异常状态下缓存数据暂不发送魔方数据 作用MOFANG_APPKEY 用来唯一标识应用的 key，应用创建时由魔方系统自动生成MOFANG_CHANNEL应用推广渠道标识，可为不同渠道提供 MOFANG_CHANNEL 值不一样的 APK 安装包， 便于统计各渠道的推广效果。 (注意：渠道标识值英文字母和数字组成，最长 24 个字符，且必须包含至少一个英文字母)2.3 添加数据监测代码在需要调用魔方 SDK 的 Activity 类中引入 com.imofan.andr
4、oid.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 取的名字，便于访问路径分析时看起来更为直观。如果不需要为每
5、个 activity 命名，则可直接调用 Mofang.onResume(Activity context)事件方法，以类名表示 activity 的名字。在对应的 Activity 的 onPause 方法里调用 Mofang.onPause(Activity context)事件方法。这里的传入参数 context 为当前 Activity 对象。Overrideprotect void onPause() super.onPause();Mofang.onPause(this);.关于添加数据监测代码，有如下事项需要注意：* 确保应用中的每个 Activity 都添加了上述监测代码，以便
6、魔方更准确地统计到用户的使用情况。* 确保每个 Activity 成对的添加了 Mofang.onResume 和 Mofang.onPause 方法。* 对有继承关系的 Activity，请不要在父类和子类的 Activity 上同时添加监测代码，否则会造成重复统计。可根据实际需要选择在父类或子类的 Activity 上添加监测代码。3. 自定义事件除了基础数据统计外，魔方还支持自定义的事件统计，例如广告被点击次数、游戏关卡被通过次数等等。 要使用自定义事件，首先需要进入魔方管理后台为对应的应用创建自定义事件。其操作流程如下：3.1 自定义事件设置进入魔方管理后台对应应用的管理界面，然后从左
7、侧菜单设置分类下选择“自定义事件管理”菜单进入自定义事件设置界面。在自定义事件设置界面右上面点击“添加事件”超链接进入新建自定义事件界面。在新建自定义事件界面填写好“事件 KEY”和“事件名称”后点击下方的 “确定”按钮，完成自定义事件的创建。3.2 添加自定义事件代码在应用程序中需要调用 Mofang.onEvent(String eventKey, String lable, int count)事件方法来触发自定义事件。其中：* eventKey 为魔方管理后台设置的自定义事件 KEY。* lable 为自定义的事件标签，使用时根据业务需要自由命名即可，无需后台事先定义（每个事件最多支持
8、 200 个标签，超出忽略）。* count 为自定义事件触发的次数，便于应用程序对事件的触发次数进行汇总，然后批量提交，以减少网络访问和流量。/汇总发送 100次焦点图广告点击事件数据Mofang.onEvent(AdClick, FocusAd, 100);/为简化使用，也可忽略 lable或 count参数/每次焦点图广告点击事件均发送数据Mofang.onEvent(AdClick, FocusAd);/不区分广告类型，汇总发送 100次广告点击事件数据Mofang.onEvent(AdClick, 100);/不区分广告类型，每次广告点击事件均发送数据Mofang.onEvent(A
9、dClick);4. 错误分析魔方数据统计 SDK 提供了两种方式收集应用程序的异常报告：自动捕获 Crash 异常以及开发者手动发送异常报告。4.1 自动捕获 Crash 异常在应用程序第一个加载的 Activity 的 onCreate 方法里调用 Mofang.enableCrashCollector(Activity context)方法即可启用程序 Crash 异常自动捕获机制。Overridepublic void onCreate(Bundle savedInstanceState) super.onCreate(savedInstanceState);Mofang.enable
10、CrashCollector(this);.4.2 手动发送异常报告若需自己捕获应用程序中的异常并手动将错误报告发送到魔方， 则可调用 Mofang.onError(Activity context, Throwable exception)方法。try . catch (Exception e) Mofang.onError(this, e);.5. 用户反馈用户反馈模块所需类:1.MFFeedback:用户反馈信息 Bean2.MFFeedbackService:用于提供用户反馈功能的服务类3.MFFeedbackSubmitListener:用于监听反馈信息提交是否成功的监听器接口4.M
11、FFeedbackReplyListener:用于监听是否有新回复的监听器接口5.1 提交用户反馈需要用到 MFFeedbackService 类的 submit()方法 此方法将回调您传入的监听器类里的onSubmitSucceeded(MFFeedback feedback)与 onSubmitFailed()两个方法submitButton.setOnClickListener(new OnClickListener() Overridepublic void onClick(View v) MFFeedbackService.submit(MFFeedbackActivity.this
12、, feedback,new MFFeedbackSubmitListener() Overridepublic void onSubmitSucceeded(MFFeedback feedback) System.out.println(提交成功);/feedback为发送的 feedback对象Overridepublic void onSubmitFailed() System.out.println(提交失败);); );5.2 获取最新回复内容需要用到 MFFeedbackService 类的 update()方法。 此方法将回调您传入的监听器类里的 onDetectedNewRep
13、lies(Listfeedbacks)与 onDetectedNothing()两个方法每次调用 update 方法后，如若更新成功，方法会自动将已更新到的内容追加存储于本地。 如果想获取本地所有已得到的反馈及回复内容则可以调用下面的 getLocalAllReply()方法即可， 此方法返回本地所有反馈及回复内容对象的集合updateButton.setOnClickListener(new OnClickListener() Overridepublic void onClick(View v) MFFeedbackService.update(MFFeedbackActivity.thi
14、s, new MFFeedbackReplyListener() Overridepublic void onDetectedNothing() System.out.println(没有更新!);Overridepublic void onDetectedNewReplies(List feedbacks) System.out.println(有更新啦!);/feedbacks为获取到的最新内容封装后对象的集合.););5.3 获取本地所有的反馈及回复信息需要用到 MFFeedbackService 类的 getLocalAllReply()方法。 调用此方法将获取本地已暂存的所有反馈及回
15、复内容对象的集合。 如若希望获取包括最新的反馈及回复 ，请在调用此方法前先调用update()方法。6. 自动更新魔方应用程序更新功能为开发者提供了两种更新机制，一种是只检查是否有更新，一种是全自动更新下载应用程序。每次更新应用程序，您只需要修改 VersionCode，把应用程序的 apk 文件上传到魔方。 MFUpdateService.check 方法会判断是否有新版应用程序，如果发现可更新的应用程序安装包， 会将更新信息返回给开发者，更新具体操作开发者将根据自己的需求完成。（魔方使用 Version Code来检测是否需要更新）我们还为开发者提供了一种自动更新功能，开发者只需要调用 M
16、FUpdateService.autoUpdate 方法，用户在弹出框中选择确认更新操作之后，安装包会自动在后台下载，并将下载进度显示到通知栏中，用户点击即可安装。 考虑到用户流量的限制，目前我们以上两种更新机制都有控制自动更新的网络模式开关（是否仅 WIFI）。下面介绍两种机制的具体操作。6.1 检查是否有更新只帮助开发者检查是否有新的安装包，其中具体的更新操作需要开发者自己去处理，在 Activity 的onCreate 方法中添加如下代码：MFUpdateService.check(this,new MFUpdateListener()Overridepublic void onWifiOff(Activity activity) Log.v(onWifiOff :,
