Pear applications are stored in an append-only log (hypercore).
Each version is identified by <fork>.<length>.<key>. The length corresponds to the length of the application's append-only log at the time.
{% embed url="https://www.youtube.com/watch?v=OTwY_avUPyI" %} Build with Pear - Episode 03: Releasing Pear Applications {% embeded %}
pear run <link> opens the application.
Before a release has been marked, the latest version is used. This is useful during development, to test the app locally and to share a preview with other peers.
Once a release has been marked, pear run <link> opens the latest marked release.
pear stage <channel name> derives an application key from the channel name and the application name (as defined in the project's package.json).
For example, a pear stage dev release channel used during development can be complemented with a production channel:
pear stage productionRunning this command in a Pear project folder outputs an application link.
Using separate channels for development and production means there is an application link for trusted peers and one for public peers.
The development link can remain unreleased, so that pear run <dev link> loads the latest staged changes by default.
The production link's releases can be marked, so that pear run <production link> loads the latest stable release by default.
Create a new release point with the latest staged changes on the production channel by running.
pear release production
Run pear help release for more info on the command.
Keep in mind that changes to an application can only propagate to peers when the application is being seeded:
pear seed production
After marking a release, make a trivial change to the project (e.g. add a console.log(...) somewhere).
First verify that it works by running pear run --dev .
Now stage the change with pear stage production.
Opening the application with pear run <link> will not output the log, because it loads the latest marked release.
The latest staged changes of a released application can be previewed with the --checkout flag:
pear run --checkout=staged <link>
The value of the --checkout flag may be staged, released (the default) or a number referring to a specific version length.
A development application link can be shared among trusted peers. At that point, it could be referred to as an internal application link (internal to the group of peers who have the link).
While using different channel names is sensible, using pear stage dev and pear stage production on the same machine has practical implications.
A dump-stage-release strategy separates the concerns between development and production, by using a different machine for each.
On the machine that holds the production link, run:
pear dump <internal-link> <path-to-app-production-dir>
This is a reverse stage: it synchronizes the application files to disk.
Once complete, the project can be staged from the production machine with:
pear stage production
Then released with:
pear release production
To allow other peers access to the new release, run pear seed production.
Asset building of distribution packages (.dmg, .msi, .appimage) is not yet possible with Pear, but will be supported in the future.