17
17
"Content-Transfer-Encoding: 8bit\n"
19
19
#: ../../source/updater.rst:5
20
# 6af36a370ebb41a586221264b327936b
20
# 9346984936654597a5502edc586d2199
21
21
msgid "Web Updater"
24
24
#: ../../source/updater.rst:7
25
# 693d48358af2449587d2b814e6f5995d
25
# 0365aee60a0b41d9ac6eccb2ce66d238
26
26
msgid "Ren'Py includes an updater that can automatically download and install updates to a Ren'Py game hosted at a website. This can be useful in keeping a large game up to date."
29
29
#: ../../source/updater.rst:11
30
# bedeb539a3714f61b68ddf2fcf3d1123
30
# 52213ac3deaf45c782704cd7b57e042d
31
31
msgid "The Ren'Py updater works by automatically performing the following steps:"
34
34
#: ../../source/updater.rst:14
35
# 76ad8c8d5a7e4bd98b25492dd3deb52b
35
# 323d9853ff5a484ba8084ef9bd8e8412
36
36
msgid "Downloading an index file that controls what is updated."
39
39
#: ../../source/updater.rst:15
40
# e7ea9c59e5344c7f9791be94c14008e2
40
# aa34bdd3f3744072a1f1ce59d2de52c5
41
41
msgid "Asking the user if he or she wants to proceed with the update."
44
44
#: ../../source/updater.rst:16
45
# 1d1aed58c5944cb6aefdd2dc5bbe02fd
45
# 8a19149103574e6d8c51db60e0517bd1
46
46
msgid "Producing an archive file from the files on disk."
49
49
#: ../../source/updater.rst:17
50
# 09a0e907b82e49cbbf90888228c3a70c
50
# 4a795c70d9b04b5e85d8ec9cd1314915
51
51
msgid "Downloading a zsync control file from the server."
54
54
#: ../../source/updater.rst:18
55
# 8db1052b2d88432f8c61d807e71d666b
55
# ab1a4e9b98c24ad9b0461b324468631d
56
56
msgid "Using the zsync tool to update the archive file to the version on the server. Zsync automatically computes the differences between the two files, and attempts to only download the portions that have changed."
59
59
#: ../../source/updater.rst:22
60
# 2fce0e64532c4a4b869f01ee030a4bd2
60
# 49228fe5a2904caaa7ca689947318e5a
61
61
msgid "Unpacking the archive, replacing the files on disk."
64
64
#: ../../source/updater.rst:23
65
# f6045fa57f2049e8a6eb6ad5c872859c
65
# 1c1d3039c36e430b963bd67e55c29a55
66
66
msgid "Deleting files that have been removed between the old and new versions."
69
69
#: ../../source/updater.rst:25
70
# 9c8c479697824f74b99c269b47b0a100
70
# be459b009dae42d29d9df0ba08f4b7e9
71
71
msgid "Restarting the game."
74
74
#: ../../source/updater.rst:27
75
# 026954d169fb42f2baf6e814b22e68e6
75
# 4024f4243f5447548e3fe7ec370ca74f
76
76
msgid "The Ren'Py updater shows an updater screen during this process, prompting the user to proceed and allowing the user to cancel when appropriate."
79
79
#: ../../source/updater.rst:32
80
# 78a52106ad544bf9b134c33697db5864
80
# 80d85539a41a4206a5f65eb42fc19906
81
81
msgid "Server Requirements"
84
84
#: ../../source/updater.rst:34
85
# dd23b981273d4269a1e924948763a829
85
# bbf7e2413d3f4aba8f974811d6de56ae
86
86
msgid "The updater requires that you provide your own hosting. You should be able to download the update files by going to the appropriate URL directly, and your server must support HTTP range queries."
89
89
#: ../../source/updater.rst:38
90
# 84b78ed052484cb695468f6ad5817d0b
90
# 09d9ee5309eb44318a7835ec3f07b70b
91
91
msgid "(This means paying for web hosting, as \"sharing\" sites tend not to support the required features.)"
94
94
#: ../../source/updater.rst:43
95
# 496f54304c7e457f9e043aaaa87cbf97
95
# 23fcd14a8e6d43f3a8d67db2e5d03e88
96
96
msgid "Building an Update"
99
99
#: ../../source/updater.rst:45
100
# 19eb6ee7702a450893bf19c316aaed05
100
# 26651305c2304935a0f5ea52ffd15260
101
101
msgid "Updates are built automatically when distributions are built. To build an update, set build.include_update to True in options.rpy. This will unlock the \"Build Updates\" option in the \"Build Distributions\" section of the launcher. Check this option, and Ren'Py will create the update files."
104
104
#: ../../source/updater.rst:51
105
# bbfc3d4cf340402d87b6309db90f3deb
105
# a944597cd76f42548252314d2d2e7efc
106
106
msgid "The update files consist of:"
109
109
#: ../../source/updater.rst:54
110
# 12908f0c274a4e179306c075680298c1
110
# 58c6fffd5cf44d2489015fa94a0299a1
111
111
msgid "updates.json"
114
114
#: ../../source/updater.rst:54
115
# 3cf82e5049864218a910f442a580989a
115
# 143948e8d6764f05af992f25226fb6a5
116
116
msgid "An index of available updates and their versions."
119
119
#: ../../source/updater.rst:57
120
# 01ca277cd6214309a837eb88361e13cd
120
# 8ce11efe3db54dd2b55ec61781c8cb42
121
121
msgid "*package*.sums"
124
124
#: ../../source/updater.rst:57
125
# 80011060bba24183813bde3214e6c129
125
# a094673a3e3f497eaceb76495c44c02e
126
126
msgid "Contains checksums for each block in the package."
129
129
#: ../../source/updater.rst:60
130
# 40211f6530ac4c9bbf7dd85840961ec3
130
# 85c42d86ecf04278bd87321fc6502a4e
131
131
msgid "*package*.update.gz"
134
134
#: ../../source/updater.rst:60
135
# 5701a4af8e42477c803ed256c0658ef2
135
# c42376be979a46f6a052e225d84e6d65
136
136
msgid "Contains the update data for the given package."
139
139
#: ../../source/updater.rst:64
140
# 7a2f4ce0a7ee4327a08cc69d06a066dd
140
# 3fc58ff0247f49548aa93947323a5c82
141
141
msgid "*package*.update.json"
144
144
#: ../../source/updater.rst:63
145
# b50a4e638ebc4ba598361e797176a71a
145
# a8e87882a827407884e4bde8971a1cd6
146
146
msgid "Contains a list of the files in each package, which the updater uses when downloading DLC."
149
149
#: ../../source/updater.rst:67
150
# 51cc3760c4284e928283dfdc3fa560c7
150
# cbf5b2fd4a814f97aa30099ee7f8cc35
151
151
msgid "*package*.zsync"
154
154
#: ../../source/updater.rst:67
155
# 311636aaf1034c78af2f2ef78237d4dc
155
# a05b74c00960461aa74b25b3cfa0db3a
156
156
msgid "This is a control file that's used by zsync to manage the download."
159
159
#: ../../source/updater.rst:69
160
# 6a961972a30f4985b7b8ef761927a6a3
160
# 5c2e981000b641de9607ac55dce4f146
161
161
msgid "You must upload all these files to a single directory on your web server."
164
164
#: ../../source/updater.rst:74
165
# 2de7e81e7adf4cd78c3546231894ab95
165
# e9de35633b2c4ae2a8b4f2cdcaa6a88b
166
166
msgid "Functions"
169
169
#: ../../source/updater.rst:76
170
# fa780b06f0934cc6b3ae6a3187a9dbf1
170
# 38a36ed5552b4bd28b9bece52f491312
171
171
msgid "To cause an update to occur, invoke either updater.update or the updater.Update action."
174
174
#: ../../source/inc/updater:5
175
# 0a26a86284de426eb0adb4867bab127c
175
# 1a6a1a58f53f42b0829abb5f35befcf7
176
176
msgid "An action that calls :func:`updater.update`. All arguments are stored and passed to that function."
179
179
#: ../../source/inc/updater:10
180
# 1cf9040a4e424d04a94e010fa86fa030
180
# 4ba29287d5fc43979f2496bc34d4e7c0
181
181
msgid "Returns true if it's possible that an update can succeed. Returns false if updating is totally impossible. (For example, if the update directory was deleted.)"
184
184
#: ../../source/inc/updater:16
185
# d64597880bb54f5890d15718b2d26cf3
185
# e287e8a8ad1a4f50bf9a1e8dd5e6d5bb
186
186
msgid "Returns a list of installed DLC package names."
189
189
#: ../../source/inc/updater:19
190
190
#: ../../source/inc/updater:31
191
# f6c70f8a66974b95a7fdcc132a497c29
192
# e96da73b72cd45afb827c23b611d627b
191
# a64d53e426494a92a1a4d3e90a1248d7
192
# fc551ae3068e4848a1def56f363caa05
196
196
#: ../../source/inc/updater:19
197
# 4112f60b9daf40edb383e8ee4d925be9
197
# efeafc202c934d87a655982375bc907b
198
198
msgid "The base directory to update. Defaults to the current project's base directory."
201
201
#: ../../source/inc/updater:24
202
# 2f811ba504744778a0c506d4fa05fd8e
202
# e054276718114e37a7418fd294ad6622
203
203
msgid "Updates this Ren'Py game to the latest version."
206
206
#: ../../source/inc/updater:27
207
# 2556172d215e45dbb107da082de99177
207
# 726b5a2dffa44e478342c4118d871033
211
211
#: ../../source/inc/updater:27
212
# 4786a0a3de254f3abe5fc52d7b1c5c82
212
# d011f4b8743c40a3a1bb3a2ffe8f9c49
213
213
msgid "The URL to the updates.json file."
216
216
#: ../../source/inc/updater:30
217
# 73cffa8141214741816dbfe862bd111f
217
# c1e7ab07be0c48efae26fc20068c7382
218
218
msgid "The base directory that will be updated. Defaults to the base of the current game. (This can usually be ignored.)"
221
221
#: ../../source/inc/updater:35
222
# 88554be2e6db4aba93ed1d1f720d6680
222
# 93a51faa58084d8eafd2b8c2b786b1e5
226
226
#: ../../source/inc/updater:34
227
# b58c8850711e4ae680e1f3b9fda23f61
227
# dc9cf2b4b84a49fb92a6069e157a901e
228
228
msgid "Force the update to occur even if the version numbers are the same. (Used for testing.)"
231
231
#: ../../source/inc/updater:39
232
# c871c043d5284e40b6f727a1c6f100c3
232
# 5fad16d34aa242d3934fc27685b31834
233
233
msgid "`public_key`"
236
236
#: ../../source/inc/updater:38
237
# dc9d965ed0c54a0cb31433a84611e6c5
237
# 14293f8280e947088b8d520bd255c5fd
238
238
msgid "The path to a PEM file containing a public key that the update signature is checked against. (This can usually be ignored.)"
241
241
#: ../../source/inc/updater:48
242
# aeb615e554df48609b501a2b464e4ede
242
# 9dc964dcb14640ad8405d7db52da66cc
243
243
msgid "`simulate`"
246
246
#: ../../source/inc/updater:42
247
# 0f412a9280ef48bc8a8143d7f5565389
247
# 72f7e0ab0f2b4b15954a72e1565bf379
248
248
msgid "This is used to test update guis without actually performing an update. This can be:"
251
251
#: ../../source/inc/updater:45
252
# f0974ccb9c494f97a06457cf2a349004
252
# f795885147d44a758e9c101681c514bd
253
253
msgid "None to perform an update."
256
256
#: ../../source/inc/updater:46
257
# 5743cb165cae43c8b488c3dfdf58c725
257
# c3ea9a2ff1af4ebaab5f3f51740b96f5
258
258
msgid "\"available\" to test the case where an update is available."
261
261
#: ../../source/inc/updater:47
262
# eae6f4bf8b704d7eb653b58ecf7529ba
262
# 8f9c63df967d4520bafd482f54060e13
263
263
msgid "\"not_available\" to test the case where no update is available."
266
266
#: ../../source/inc/updater:48
267
# 7293df2447c042bf9299bc5fe60996cf
267
# 34c1da7d76e94be79926b78f401185fd
268
268
msgid "\"error\" to test an update error."
271
271
#: ../../source/inc/updater:52
272
# caecb4b8e47847c9b8a63ba8d7f14875
272
# fe0ce53bc74948b9bc08da91bac3e824
276
276
#: ../../source/inc/updater:51
277
# 2f48804c742f469cb861f0e15d95cd07
277
# 162a231ee42042fea19f072e2c110807
278
278
msgid "A list of packages to add during this update. This is only necessary for dlc."
281
281
#: ../../source/inc/updater:54
282
# a74cff1a73b1499aaf0000d6718d6f5c
282
# e8e98e3df23548e6bf8cf8b2606b3fe6
283
283
msgid "`restart`"
286
286
#: ../../source/inc/updater:55
287
# bb1e54cfdcff4a5384fc7e1120101310
287
# 44acd40e2bd74ab6b52971cf97bd44c4
288
288
msgid "Restart the game after the update."
291
291
#: ../../source/updater.rst:82
292
# 9d5acc6185cc468b8dfeda274e485544
292
# e058e702e3144ec5979032ae82df612b
296
296
#: ../../source/updater.rst:84
297
# 111ea32499c149aeb77c62dca797871b
297
# 189bd4498a784e8c92aa36aac36bf8a9
298
298
msgid "To customize the look of the updater, you may override the ``updater`` screen. The default screen is defined in common/00updater.rpy."