Sparkling Appcast allows you to use your WordPress site to distribute your macOS App via Sparkle offering an appcast.xml endpoint.

usielriedl

<p>Sparkling Appcast is a WordPress plugin. It allows you to use your WordPress site to distribute your macOS App via <a href="https://sparkle-project.org/" rel="nofollow ugc">Sparkle</a>. Sparkling Appcast supports multiple channels (alpha, beta, …).</p>
<p>Sparkling Appcast exposes a new shortcode to display a list of app builds.</p>
<pre><code>[sappcast_display_builds sappcast_channel="{channel-id-or-slug}"]
</code></pre>
<p>Configure Sparkle to ingest the appcast.xml at https://your.site/wp-json/sparkling-appcast/v1/appcast.xml. You will see something like the following XML.</p>
<pre><code><rss xmlns:sparkle="http://www.andymatuschak.org/xml-namespaces/sparkle" xmlns:dc="http://purl.org/dc/elements/1.1/" version="2.0">
    <channel>
        <title>MyApp</title>
        <link>/wp-json/sparkling-appcast/v1/appcast.xml</link>
        <item>
            <title>Version 1.0.1 (2)</title>
            <description><![CDATA[ This version is better but not yet released! ]]></description>
            <sparkle:channel>Alpha</sparkle:channel>
            <sparkle:version>2</sparkle:version>
            <sparkle:shortVersionString>1.0.1</sparkle:shortVersionString>
            <pubDate>Wed, 08 Jan 2025 08:56:19 +0000</pubDate>
            <sparkle:minimumSystemVersion>14.0</sparkle:minimumSystemVersion>
            <enclosure url="http://localhost:8088/wp-content/uploads/2025/01/app_v2.zip" length="4713394" type="application/octet-stream"/>
        </item>
        <item>
            <title>Version 1.0.0 (1)</title>
            <description><![CDATA[ - New features - New bugs ]]></description>
            <sparkle:version>1</sparkle:version>
            <sparkle:shortVersionString>1.0.0</sparkle:shortVersionString>
            <pubDate>Wed, 08 Jan 2025 07:43:06 +0000</pubDate>
            <sparkle:minimumSystemVersion>14.0</sparkle:minimumSystemVersion>
            <enclosure url="http://localhost:8088/wp-content/uploads/2025/01/app_v1.zip" length="4713394" type="application/octet-stream"/>
        </item>
    </channel>
</rss>
</code></pre>
<h3>Configuration</h3>
<p>To get started name the application you want to distribute on your WordPress site. You can find the settings page under the App Builds menu.</p>
</p>
<p>If you have multiple channels besides <code>stable</code>, you can should add them on wp-admin under the App Builds menu.</p>
</p>
<h3>Usage</h3>
<h3>Fastlane</h3>
<p>We recommend you use the <a href="https://github.com/Usiel/fastlane-plugin-wp_sparkling_appcast" rel="nofollow ugc"><code>wp_sparkling_appcast</code> plugin</a> to upload assets and create builds.</p>
<h3>Other</h3>
<p>To distribute a new build, you must upload the asset (1), create a build draft (2), after which you can finalize the build and publish it (3). Steps 1 and 2 are typically executed by your build server, while step 3 is done by a human.</p>
<h3>1. Uploading Asset</h3>
<pre><code>curl --location "localhost:8088/wp-json/wp/v2/media?status=publish&title=MyApp%20${VERSION}%20(${BUILD_NUMBER})" \
    --header "Content-Disposition: attachment; filename=\"myapp_v${VERSION}_${BUILD_NUMBER}.zip\"" \
    --header 'Content-Type: application/zip' \
    --user "${USER}:${APPLICATION_PASSWORD}" \
    --data-binary '@/path/to/asset.zip'
</code></pre>
<h3>2. Create Build Draft</h3>
<pre><code>curl --location 'localhost:8088/wp-json/wp/v2/sappcast_app_build' \
    --header 'Content-Type: application/json' \
    --user "${USER}:${APPLICATION_PASSWORD}" \
    --data '{
        "meta": {
            "sappcast_app_build_version": string,
            "sappcast_app_build_number": int,
            "sappcast_app_build_min_system_version": string,
            "sappcast_app_build_attachment_id": int,
            "sappcast_app_build_changelog": string,
        },
        "sappcast_channel": int,
        "status": "draft"
    }'
</code></pre>
<h3>3. Publish Build</h3>
<p>The user may now go to “App Build” on wp-admin and publish the draft after verifying the build. After publishing the build will appear on the relevant appcast (<code>/wp-json/sparkling-appcast/v1/appcast.xml</code>).</p>


Alternatives to Sparkling Appcast

Top alternatives