首页 >Mac开发

为你的Cocoa应用程序加入更新支持:Sparkle 简介

2010-09-20 13:06 编辑: mac52ipod 分类:Mac开发 来源:CocoaChina

转自 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

wpid-wpid-xcodecocoaapplication-2010-09-10-16-11-2010-09-10-16-11.png

 

wpid-wpid-cocoaapplicationwithsparkle-2010-09-10-16-11-2010-09-10-16-11.png
2: 去到Sparkle下载Sparkle Framework,最新版本为 1.5b6,

wpid-wpid-sparkle-2010-09-10-16-11-2010-09-10-16-11.png
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)”前面的复选框。

wpid-wpid-addsparkletotestsparkle-2010-09-10-16-11-2010-09-10-16-11.png

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

wpid-wpid-addcopyfilesbuildphase-2010-09-10-16-11-2010-09-10-16-11.png
5: 右键点击这个新建的Copy Files Build Phase,并在弹出窗口中,点击Destination下拉框,选择Frameworks

wpid-wpid-copyfilesbuildphaseforframework-2010-09-10-16-11-2010-09-10-16-11.png
6: 将Linked Framworks下的Sparkle.framework拖拽到这个新建的Copy Files Build Phase 中

wpid-wpid-addsparkle-2010-09-10-16-11-2010-09-10-16-11.png
7: 在Interface Builder中打开TestSparkle的MainMenu.xib(nib), 然后点击Interface Builder–>Files–>Read Class Files

wpid-wpid-readclassfiles-2010-09-10-16-11-2010-09-10-16-11.png

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

wpid-wpid-readheaderfiles-2010-09-10-16-11-2010-09-10-16-11.png
9: 从Library中拖拽一个 NSObject到MainMenu主窗口.

wpid-wpid-addobject-2010-09-10-16-11-2010-09-10-16-11.png

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

wpid-wpid-SUUpdater-2010-09-10-16-11-2010-09-10-16-11.png

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

wpid-wpid-Checkupdatesmenuitem-2010-09-10-16-11-2010-09-10-16-11.png

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

wpid-wpid-addactionforupdate-2010-09-10-16-11-2010-09-10-16-11.png
13: 保存Interface Builder的所有更改,退出Interface Builder。

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

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

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

执行,

ruby generate_keys.rb

这个命令将会生成两个文件 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

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 你的显示可能与此不同,,,,

wpid-wpid-websharing-2010-09-10-16-11-2010-09-10-16-11.png
17: 打开你的XCode中 TestSparkle 工程,编辑 TestSparkle-Info.plist,加入两个属性,SUPublicDSAKeyFile 和 SUFeedURL

wpid-wpid-info.plist-2010-09-10-16-11-2010-09-10-16-11.png

其中,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

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

wpid-wpid-checkforupdates-2010-09-10-16-11-2010-09-10-16-11.png

将此 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文件夹中,

wpid-wpid-signing-2010-09-10-16-11-2010-09-10-16-11.png

打开终端进入到此文件夹,执行:

ruby sign_update.rb TestSparkle_1.1.zip dsa_priv.pem

wpid-wpid-sign-2010-09-10-16-11-2010-09-10-16-11.png
便可得到升级包的签名,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,我们会看到

wpid-wpid-feed-2010-09-10-16-11-2010-09-10-16-11.png

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

这段指定的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,具体路径依你个人配置而定)

wpid-wpid-path-2010-09-10-16-11-2010-09-10-16-11.png
然后在浏览器敲入 http://10.0.1.2/~buick/testsparkleappcast.xml

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

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

wpid-update1-2010-09-10-16-11.png

点击Install Update,如果更新成功,即可显示:

wpid-complee-2010-09-10-16-11.png

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

wpid-latest-2010-09-10-16-11.png

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

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

搜索CocoaChina微信公众号:CocoaChina
微信扫一扫
订阅每日移动开发及APP推广热点资讯
公众号:
CocoaChina
我要投稿   收藏文章
上一篇:苹果OpenCL技术概述
下一篇:除去 Tableview 边缘的淡蓝色的方法
我来说两句
发表评论
您还没有登录!请登录注册
所有评论(0

综合评论

相关帖子

sina weixin mail 回到顶部