Sparkle使用方法(mac软件自动升级开源类库)

类库官网:https://sparkle-project.org/

原文:http://www.cocoachina.com/mac/20100920/2111.html


作为一名桌面软件开发者,应该提早考虑程序的更新问题。如何将程序更新及时优雅的推送给用户,是维持用户忠诚度和提高软件使用体验的一个重要方面。而作为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: 从Library中拖拽一个 NSObject到MainMenu主窗口.

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

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

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

10: 保存Interface Builder的所有更改,退出Interface Builder。

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

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

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

执行,

ruby generate_keys.rb

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

12: 建立一个 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为你的程序加入更新支持。

13 打开你的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文件夹中,

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

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

便可得到升级包的签名,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:shortVersionString="3.0" 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” 是buile的版本号,在更新的时候以shortVersion为主

sparkle:shortVersionString="3.0" 是指当前更新包版本号,客户端程序就是根据这个版本号来和本地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 拷贝到服务器上

然后在浏览器敲入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下即可。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,491评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,856评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,745评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,196评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,073评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,112评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,531评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,215评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,485评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,578评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,356评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,215评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,583评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,898评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,174评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,497评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,697评论 2 335

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,497评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,056评论 25 707
  • 童年的记忆总是那么的美好,叫人时常想起且深切怀念。在物质相对匮乏的七十年代初期,我们有趣的童年至今令人魂牵梦绕...
    栎风唐勇阅读 396评论 3 3
  • “商业模式”这个概念随着互联网时代的发展已经成为当今社会炙手可热的话题。最近在咖啡厅、餐馆总能听到隔壁兴致勃勃的聊...
    周博文阅读 3,042评论 0 22
  • 首次使用,感觉不错,高大上.
    毛毛弟阅读 297评论 0 0