终端开发

使用Android Studio开发可独立运行(runnable)混淆过的Jar程序 Android安装包精简系列之资源精简 Android安装包精简系列之图片优化 Android安装包精简系列之为什么要优化精简安装包 Android安装包精简系列(总纲) Android安装包精简系列之图标转字体 gradle相关资料汇总 Android编译常见错误解决 Android编译编译速度提升 终端基于gradle的开源项目运行环境配置指引 制作终端产品演示的gif 一个关于APK Signature Scheme v2签名的神奇bug定位经历 如何随apk一起打包并使用SQLite SDK热更之gradle插件(如何在SDK代码中自动插桩及如何生成补丁包) 关于Android的APK Signature Scheme v2签名相关的资料汇总 封装HttpURLConnection实现的简单的网络请求库 一款基于Java环境的读取应用包名、签名、是否V2签名等基本信息的工具 Android的APK Signature Scheme v2签名及一款基于Java环境的校验工具介绍 如何使用Eclipse开发可执行Jar程序,并生成混淆过的jar程序 Android 相关的学习资料整理(持续更新) macOS(Sierra 10.12)上Android源码(AOSP)的下载、编译与导入到Android Studio Google也看不下去被玩坏的悬浮窗了么? Android开发常用工具资源 SDK热更系列之概述(持续整理编辑中~) SDK热更系列之SDKHotfix待优化点 Android 终端开发相关的一些神图(持续更新) SDK热更系列之Demo项目介绍概述 SDK热更系列之Demo体验方法 SDK热更系列之如何获取应用在当前设备上的so对应的指令集 Gradle Android插件使用的中那些特别注意的点 Experimental Plugin User Guide(From Android Tools Project Site) 基于Android Studio使用gradle构建包含jni以及so的构建实例 基于Instrumentation框架的自动化测试 - Android自动化测试系列(四) Instrumentation框架介绍-Android自动化测试系列(三) 关于终端设备的设备唯一性的那些事之MAC地址 关于终端设备的设备唯一性的那些事之IMEI Android 检查应用是否有root权限 ant常见错误解决方案 Gradle介绍 iMac上Android Studio 相关设置及常见问题 再说adb 再看Android官方文档之分享 再看Android官方文档之Fragment&数据保存 再看Android官方文档之Activity&Intent 再看Android官方文档之ActionBar和兼容性 adb shell input(Android模拟输入)简单总结 再看Android官方文档之建立第一个APP Android开发调试常用工具 ANR(网络资料整理) Java参数引用传递引发的惨案(又一次Java的String的“非对象”特性的踩坑经历) android.view.WindowManager$BadTokenException,Unable to add window Android签名校验机制(数字证书) Robotium二三事-Android自动化测试系列(二) Robotium介绍-Android自动化测试系列(一) Android开发中遇到的那些坑 Eclipse使用中部分经验总结 Android中关于Nativa编译(NDK、JNI)的一些问题 Android简单实现的多线程下载模块 Android内存耗用之VSS/RSS/PSS/USS adb Advanced Command URL编码中的空格(编码以后变为+) Android MD5后 bye数组转化为Hex字符串的坑(记一次为女神排忧解难的经历) Android学习之路 adb Base Command Android Log的那些坑…………

标签

android 46

Android编译常见错误解决 一个关于APK Signature Scheme v2签名的神奇bug定位经历 关于Android的APK Signature Scheme v2签名相关的资料汇总 封装HttpURLConnection实现的简单的网络请求库 一款基于Java环境的读取应用包名、签名、是否V2签名等基本信息的工具 Android的APK Signature Scheme v2签名及一款基于Java环境的校验工具介绍 如何使用Eclipse开发可执行Jar程序,并生成混淆过的jar程序 Android 相关的学习资料整理(持续更新) macOS(Sierra 10.12)上Android源码(AOSP)的下载、编译与导入到Android Studio Android开发常用命令备忘 Google也看不下去被玩坏的悬浮窗了么? Android开发常用工具资源 Android 终端开发相关的一些神图(持续更新) Gradle Android插件使用的中那些特别注意的点 Experimental Plugin User Guide(From Android Tools Project Site) iMac(OS X)搭建私有maven仓库,提供Nexus Responsitory镜像 基于Android Studio使用gradle构建包含jni以及so的构建实例 基于Instrumentation框架的自动化测试 - Android自动化测试系列(四) Instrumentation框架介绍-Android自动化测试系列(三) 关于终端设备的设备唯一性的那些事之MAC地址 关于终端设备的设备唯一性的那些事之IMEI Android 检查应用是否有root权限 iMac(OS X)El Capitan 更新遇到的那些坑 ant常见错误解决方案 Gradle介绍 iMac上Android Studio 相关设置及常见问题 再说adb 再看Android官方文档之分享 再看Android官方文档之Fragment&数据保存 再看Android官方文档之Activity&Intent 再看Android官方文档之ActionBar和兼容性 adb shell input(Android模拟输入)简单总结 再看Android官方文档之建立第一个APP Android开发调试常用工具 ANR(网络资料整理) Java参数引用传递引发的惨案(又一次Java的String的“非对象”特性的踩坑经历) android.view.WindowManager$BadTokenException,Unable to add window Android签名校验机制(数字证书) Eclipse使用中部分经验总结 Android内存耗用之VSS/RSS/PSS/USS adb Advanced Command URL编码中的空格(编码以后变为+) Android MD5后 bye数组转化为Hex字符串的坑(记一次为女神排忧解难的经历) Android学习之路 adb Base Command Android Log的那些坑…………

怎样的版本历史才是一个好的版本历史

2014年11月10日

做SDK一直以来,除了之前提过的文档的问题,另一个比较多的抱怨就是关于版本更新。由于

  • SDK版本比较多,而且迭代较快,
  • 同时提供的版本历史太过简单。

当游戏接入新功能的时候,很容易遇到的问题就是需要替换版本时,他们从老版本升级到当前版本要做什么,他们无法知道对应的功能更新在什么地方可以看到,或者他们需要做什么工作。

为了解决这个问题,SDK的版本做了几次更新,最后形成了一个还在试验中,但是感觉已经相对会明晰很多的版本历史记录方法,作为参考。

最早的版本说明

最早期的版本文档,只是简单记录了版本变更的概要,例如:

XX版本变更内容

1. 增加了XX功能
2. 修复了XX引起的一个bug
3. ……

里面只是简单列出变更的内容,开发商无法了解到变更的内容,以及更新需要做的工作,尤其是由于SDK内容较多,导致文档内容很多。开发商每次都要彻底过一遍文档,然而大部分内容没有变更,导致开发商极易遗漏一些小的变更点。初期曾尝试在文档中做变更标记,后来发现随着版本增多,文档可读性越来越低。最后还是采用版本历史来描述版本变更内容,在版本历史中同时增加SDK和文档变更的内容。

##更新以后的版本说明

这次调整以后,版本更新概要变成如下的样子:

XX版本变更内容

代码变更:
	1.XX功能变动
		【修改】 调整XXX接口
	2.修复XXbug
		【删除】 删除XX代码的某处理逻辑,解决XXX引起的问题
	3.……       
文档调整:
	【删除】 删除第X章XX部分对于某功能的说明
	【修改】 增加对XX接口调用事例的说明

这次调整以后明显有了改观,但是游戏还是有意见,他们认为没有虽然很清晰,但是其实里面有一些内容他们并不需要关注,但是罗列在一起还是相对繁杂。另外上面的模式,不方便使用markdown编辑,根据意见最终修改为下面的格式:

当前的版本说明

目前SDK使用的就是下面的版本更新说明,当然这也并不最好的模式,版本更新文档变的越来越大。我们也在尝试更好的方式。

### XX版本变更内容

#### 代码变更:

- 新增功能:
	1. XX功能
		XX功能主要提供……
	- 增加API XXX
		通过XXAPI,可以轻松实现…………
- 功能调整:
	1. XX API调整
		将XX API的参数从int转为枚举……
- BUG修复
	1. 修复XX逻辑引起的XX问题
	
#### 文档调整:

- 增加:
	1. XX模块增加关于XX功能的描述(Wiki链接)
- 修改:
	1. 修改XX模块中关于XX功能的权限声明(Wiki链接)
	- ……


PS:我的博客即将搬运同步至腾讯云+社区,邀请大家一同入驻:https://cloud.tencent.com/developer/support-plan?invite_code=10zhijuy24v4f

赞赏

取消
微信扫一扫,赞赏子勰
扫码支持
屌丝程序猿,鸡血攻城狮!努力学技术,潜心做精品!