RTY 实践出真知

转自 ibuick.com，原文  http://ibuick.com/index.php/archives/add-automatic-update-support-over-cocoa-app-via-sparkle-framework

作为一名桌面软件开发者，应该提早考虑程序的更新问题。如何将程序更新及时优雅的推送给用户，是维持用户忠诚度和提高软件使用体验的一个重要方面。而作为Cocoa应用程序开发者，我们可以选择自己手动来实现此功能，也可以选择一些优秀的开源框架。Sparkle就是其中之一。

Sparkle是一个非常简单且易用的Cocoa应用程序更新框架。本篇文章将使用一个简单的例子，教你如何使用Sparkle为你的Cocoa应用程序加入更新支持。

1: 新建一个Cocoa Application，TestSparkle

2: 去到Sparkle下载Sparkle Framework，最新版本为 1.5b6,

Sparkle Test App.app 是一个用来演示Sparkle更新框架的一个应用程序。

Extras文件夹下提供了Sparkle的标准图标，Release Notes模版，软件签名工具，源代码和Appcast.xml示例文件，我们后面会再讲到这些工具和文件。

With Garbage Collection, 是一个加入了Garbage Collection支持的Sparkle分发版，如果你的应用程序运行在有GC的环境下，则可以使用这个版本的Sparkle

Sparkle.framework 是通用分发版，笔者建议大家使用此版本的Sparkle。

3: 链接Sparkle框架到TestSparkle工程

拖拽Sparkle.framework(或 with Garbage Collection下的 Sparkle.framework)到TestSparkle的Linked Frameworks下，在弹出窗口中记得选中”Copy items into destination group’s folder (if needed)”前面的复选框。

4: 为你的工程新建一个Copy Files Build Phase,

5: 右键点击这个新建的Copy Files Build Phase，并在弹出窗口中，点击Destination下拉框，选择Frameworks

6: 将Linked Framworks下的Sparkle.framework拖拽到这个新建的Copy Files Build Phase 中

7: 在Interface Builder中打开TestSparkle的MainMenu.xib(nib), 然后点击Interface Builder–>Files–>Read Class Files

8: 将Sparkle.framework中的所有头文件选中并读取

9: 从Library中拖拽一个 NSObject到MainMenu主窗口.

10: 点击此Object对象，点击Inspector，设定此Object的Class为 SUUpdater

11: 添加一个菜单项到到TestSparkle Menu，重命名为 Check For Updates…

12: 将 Check for Updates…菜单项的Send Actions指向Updater Object的checkForUpdates方法

13: 保存Interface Builder的所有更改，退出Interface Builder。

14: 为了安全防止应用程序更新遭到恶意篡改，我推荐对应用程序更新添加数字签名。

Sparkle使用DAS SHA-1 来对程序更新包进行数字签名。

打开终端，进入步骤2中存放已下载的Sparkle包的文件夹，进入Extras–>Signing Tools，

执行,

这个命令将会生成两个文件 dsa_priv.pem 和 dsa_pub.pem，也就是私钥和公钥，请妥善保存这两个文件，如果私钥丢失，你得用户将再也无法自动通过已安装的程序来获得更新的更新。

15: 建立一个 App Cast Feed文件

Sparkle的运作机理其实非常简洁，本地应用程序Info.plist中含有一个URL，此URL指向一个在你网站上的App Cast Feed XML文件。当你发布更新的时候，上传新的app到你的网站，更新此app cast xml feed。这样，客户端程序在运行检查更新时，会根据Info Plist中的URL找到并Parse此文件，跟本地软件版本进行比对。如果发现更新，则提示用户。这就是App Cast XML Feed文件的作用。

在步骤14中提到的Extras文件夹下，有一个App Cast XML Feed文件的模版：

http://you.com/app/2.0.html

Wed, 09 Jan 2006 19:20:11 +0000

http://you.com/app/1.5.html

Wed, 01 Jan 2006 12:20:11 +0000
<!-- Now here's an example of a version with a weird internal version number (like an SVN revision) but a human-readable external one. -->
http://you.com/app/1.4.html

Wed, 25 Dec 2005 12:20:11 +0000

我们可以看出，这其实是一个标准的RSS Feed格式的XML文件。我们只要修改相应的项目即可。

下面我们就来一步步的演示如何使用Sparkle为你的程序加入更新支持。

16: 我们首先在本地搭建一个可用于测试软件更新的网站。打开Mac OS X系统偏好设置(System Preferences), 找到共享(Sharing)，开启Web共享(Web Sharing)，并通过点击图中所示URL测试Web共享是否成功开启。http://10.0.1.2/~buick 你的显示可能与此不同，，，，

17: 打开你的XCode中 TestSparkle 工程，编辑 TestSparkle-Info.plist，加入两个属性，SUPublicDSAKeyFile 和 SUFeedURL

其中，SUFeedURL 将是指向一个 App Cast XML Fee 的 URL，比如我的测试地址是 http://10.0.1.2/~buick/testsparkleappcast.xml ，SUPublicDSAKeyFile 指向公钥，我们把刚才步骤14中生成的 dsa_pub.pem 加入到工程的Resources中，并在 TestSparkle-Info.plist 中指定此公钥的名称，，，，那么现在的TestSparkle-Info.plist应该是这样

整个配置完成，我们现在来构建一个TestSparkle.app的1.0版本，点击Build and Run

启动TestSparkle.app, 在TestSparkle菜单下，确认Check for Updates…按钮处于可用状态，如果是灰色不可点击，则返回Interface Builder修改。

将此 TestSparkle.app 1.0 版本拷贝到别处备用。然后返回XCode，将应用程序版本改为1.1,然后构建工程。将TestSparkle.app 的1.1版本打包成zip文件，改名为TestSparkle_1.1.zip

将 dsa_priv.pem (私钥) 和 TestSparkle_1.1.zip 拷贝到 Extras下的Signing Tool文件夹中，

打开终端进入到此文件夹，执行：

便可得到升级包的签名，MCwCFDZsrVGB+PewvxioJcvptkqchXi3AhQOZDJ4UukRM2/bYmZzzbHTxM2kpA==

用文本编辑器创建一个xml文件(UTF-8 编码)，内容如下：

http://10.0.1.2/~buick          The latest TestSparkle updates from localhost, more hot features and sweeties
en

Fri, 10 Sept 2010 0:00:00 +0300             http://10.0.1.2/~buick

注意(由于本网站HTML的设置问题，如果你直接拷贝以上XML Feed文件到你本地测试可能会出编码问题导致XML Parse失败，请到本文最后下载此文件，以及工程压缩包)。

把此XML另存为 testsparkleappcast.xml

熟悉RSS Feed的读者可能很容易理解此文件，，如果我们在浏览器中直接访问此URL，我们会看到

而我们要关注的只是这两段:

这段指定的URL是一个介绍页面，如果你希望在更新提示窗口中出现一个介绍新版本的页面(或者说release notes)，则使用此URL定向到你网站上的新版本介绍页面。

Sparkle非常贴心的为大家提供了一个模版，在Extras/Release Notes Templates 文件夹下可找到

enclosure sparkle:version=“1.1” sparkle:dsaSignature=“MCwCFDZsrVGB+PewvxioJcvptkqchXi3AhQOZDJ4UukRM2/bYmZzzbHTxM2kpA==“ url=“http://10.0.1.2/~buick/TestSparkle_1.1.zip” length=“436264” type=“application/octet-stream”/>

这段是实现Sparkle Update的关键，

sparkle:version=“1.1” 是指当前更新包版本号，客户端程序就是根据这个版本号来和本地APP进行比对，如果发现不同则提示更新。

sparkle:dsaSignature=“MCwCFDZsrVGB+PewvxioJcvptkqchXi3AhQOZDJ4UukRM2/bYmZzzbHTxM2kpA==“ 这个就是我们刚才为更新包生成的数字签名

url=“http://10.0.1.2/~buick/TestSparkle_1.1.zip” 指向更新包下载地址

length=“436264” 指更新包的大小，上传上去前用 终端 ls -al 命令可查看

type=“application/octet-stream” 是一个想对固定的值，一般不用修改。

现在把testsparkleappcast.xml 和 TestSparkle_1.1.zip 拷贝到

你的用户主目录/Sites 下 (~/Sites,具体路径依你个人配置而定)

然后在浏览器敲入 http://10.0.1.2/~buick/testsparkleappcast.xml

如果能够看到类似网页，，，说明一切正常。

下面找到我们刚才保存的TestSparkle.app 1.0版本，运行并点击 Check for Updates… 如果一切正常，你可以看到

点击Install Update，如果更新成功，即可显示：

然后再次点击Check for Updates, 你会看到

最后希望你与Sparkle合作愉快。

点击此处下载本次工程源代码和示例XML Feed文件，另外，安装包里面还带有一个Sparkle的简体中文包，将它放入你的Sparkle.framework/Resources下即可。