软件系统升级的设计说明书.doc

百度移动推广SDK 用户手册 (Android版) 2.1 百度在线网络技术（北京）有限公司 （版权所有,翻版必究） 修改记录 版本 更新时间 变更内容 1.0 2011-7-24 文档创建 2.0 2012-5-8 增加“接口和监听器”章节 2.0 2012-5-8 增加“常用接口” 2.0 2012-5-8 增加“监听器” 2.0 2012-5-8 增加“附件1 申请APPSID、APPSEC” 2.1 2012-8-15  目录 一、 简介 4 二、 阅读对象 4 三、 运行环境 4 四、 工程设置 4 1. 申请应用APPSID和计费名 4 2. 导入JAR包 5 3. 文档使用 5 4. 配置AndroidManifest.xml 5 5. 声明式布局 6 6. 代码式布局 7 7. 代码混淆 8 五、 接口和监听器 8 1. 常用接口 8 2. 监听器 8 六、 示例 9 七、 联系我们 9 八、 附件1：申请APPSID、APPSEC 11 简介 百度移动推广SDK(Android)是百度官方推出的移动推广SDK在Android平台上的版本（以下简称SDK）。SDK的发行版本（完整下载包为android.zip）中包括JAR包、文档、示例以及您正在阅读的用户手册。 以下使用SDK_PATH代表android.zip解压后的根目录。 JAR包：SDK_PATH/android_api.jar，开发过程中导入Android项目； 文档：SDK_PATH/android_doc，提供开发帮助信息； 示例：SDK_PATH/android_demo，从易到难的多个示例程序代码，帮助您迅速熟悉SDK的使用方式； 用户手册：本文档。 阅读对象 本文档面向所有使用该SDK的开发人员、测试人员、合作伙伴以及对此感兴趣的其他用户。 运行环境 可运行于Android 1.5（API Level 3）及以上版本。 工程设置 （注：以下提及的各个文件均可在SDK_PATH/android_demo中找到。） 申请应用APPSID和计费名 首先，你需要在AndroidManifest.xml中设置meta-data（详见“4 配置”）BaiduMobAd_APP_ID(简称”APPSID”)和BaiduMobAd_APP_SEC（下称“计费名”）。APPSID和计费名在百度移动推广平台申请，只有使用生效的应用版本的APPSID和计费名才能正常计费。调试期间您可以使用“debug”。 SDK 2.0开始您还可以通过调用AdView.setAppSid和AdView.setAppSec设置对应值。 导入JAR包 将SDK中的JAR包导入您创建的Android项目，以下假设您已经创建了项目A。 右键点击你的工程，然后选择”Properties”； 在工程属性对话框左边选择”Java Build Path”； 在工程属性对话框主窗口选择”Libraries”； 点击”Add JARs”，添加SDK_PATH/android_api.jar。 文档使用 若是在eclipse或其他IDE下开发，可设置JAR包的Javadoc路径为SDK_PATH/doc，便于在IDE中获得即时的开发帮助信息； 也可以直接在浏览器中打开SDK_PATH/doc/index.html查看该文档。 配置AndroidManifest.xml 具体的信息参见图1。加亮文字标示了需要配置的信息： meta-data：BaiduMobAd_APP_ID为应用程序的发布ID，如此处为debug，请根据需要替换；BaiduMobAd_APP_SEC为计费名，测试期间为“debug”，正式上线后可以替换。 上述2个信息，可以通过AdView.setAppSid和AdView.setAppSec设置，并且会覆盖AndroidManifest.xml中的设置。注：调用需要在AdView实例化之前进行，可参见Demo中的“代码式布局”，“高级应用（文本）”代码中的注释部分。 添加AppActivity申明 添加必要的权限 必要权限：您必须申明的权限 可选权限：您可根据实际需求设置 图1 AndroidManifest.xml 声明式布局 参照以下步骤（参见示例程序中“声明式布局”、“高级应用”）： 在A中/res/layout/simple_declaring.xml声明 com.baidu.mobads.AdView： 首先在第一个xml布局元素中添加baiduadsdk名