Skip to content

Commit 28a79bb

Browse files
committed
Document pling-v1-zsync transport method
1 parent 184cf88 commit 28a79bb

File tree

1 file changed

+23
-0
lines changed

1 file changed

+23
-0
lines changed

draft.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -220,6 +220,29 @@ Filename | String | `Subsurface-*x86_64.AppImage.zsync` | Filename of the [zsync
220220
**Please note that pre-releases are not being considered when using `latest`.** You will have to explicitly provide the name of a release. When using e.g., [uploadtool](https://github.com/probonopd/uploadtool), the name of the release created will always be `continuous`, hence, you can just specify that value instead of `latest`.
221221

222222

223+
##### Pling/AppImageHub
224+
225+
[Pling](www.pling.com) is a contents store which allows uploading AppImages. It also includes an AppImage exclusive catalog which is available at [www.appimagehub.com](). This transport method
226+
extends [zsync] and uses the file name sorting to determine the latest release. Its [update information] is in the form
227+
228+
```
229+
pling-v1-zsync|1623134|*-stable-x86_64.AppImage
230+
```
231+
232+
233+
If an [AppImage] has [update information] embedded for this transport mechanism, then the following fields **MUST** be used; separated by a "|" character:
234+
235+
Field | Type | Example | Comments
236+
----------- | ------ | -------- | --------
237+
Transport mechanism | String | `pling-v1-zsync` | [AppImage] file **MUST** be stored in pling.com
238+
Product ID | String | `1623134` | Id given by pling.com when the product is created.
239+
File Matching Pattern | String | `*-stable-x86_64.AppImage` | [Wildcard matching expression](http://www.gnu.org/software/libc/manual/html_node/Wildcard-Matching.html), **MAY** contain a release channel name. **MUST** contain the target architecture. When sorted by file name they **MUST** follow the release order.
240+
241+
**Please notice** that all file names must follow an specific pattern defined by the packager (you). But it's recommended to include the target application name, the version, the release channel, the architecture and the `.AppImage` extensions as follows: `bash-5.4.0-stable-x86_64.AppImage`. You **MUST NOT** upload the zsync file to the Pling store.
242+
243+
You can visit https://www.pling.com/product/add to register a new product on the Pling store.
244+
245+
223246
##### bintray-zsync
224247

225248
The __bintray-zsync__ transport was there to support [Bintray](https://bintray.com/). It is deprecated.

0 commit comments

Comments
 (0)