arrow-left

All pages
gitbookPowered by GitBook
1 of 1

Loading...

Submission Process

The submission process for AppCenter, broken down into a few short steps

circle-info

Please make sure to review the publishing requirements before submitting your app

hashtag
Create a New Release

Before you can publish your app, you'll need to . It is important that you use a without a pre-release tag when releasing.

hashtag
Submit for Review

triangle-exclamation

It is important to before completing this step

To submit your app to AppCenter, you'll need to create a new JSON file describing your app release in the AppCenter Reviews repository on Github:

Name the file using your app's id with the json file extension. Fill in the contents of the file with the link to your git repository, the commit hash from your latest release, and the version number of that release:

The source field needs to be a publicly accessible Git repository. The commit field is the full Git sha for the release you're submitting. And the version field needs to be a tag.

Once you've submitted the new file as a pull request to the AppCenter Reviews repository, your app will now be in the review queue!

hashtag
Wait for Testing

All apps and updates in the review queue are listed as . Once a pull request is approved and merged by a reviewer, that app will be published to the . Depending on demand, this may take several days.

hashtag
Resolve Issues

Your app will go through an automated build process when it has been accepted by a reviewer. It will need to pass the Parse and Build steps listed in GitHub CI at the bottom of the pull request. If either of those steps fail, please inspect the build log to resolve issues.

If any questions or requested changes come up during the review process, the reviewer will use the conversation on the pull request and may mark it as "Changes Requested". You will need to correct these issues, create a new release of your app, and update the pull request with your new release.

The reviewer may also make some suggestions for best practices, inform you of new features, or link you to documentation.

hashtag
Available on AppCenter

When your app passes automated testing and human review, it will become available in AppCenter in elementary OS.

hashtag
Publishing Updates

If you wish to , you can restart the submission process by creating a new release on GitHub. Then navigate to the , modify your app's json file with the latest commit hash and release tag, and submit that change as a pull request to begin a new review process.

release it on GitHubarrow-up-right
Semantic Versioning Numberarrow-up-right
make changes to your app's monetization status
SemVerarrow-up-right
open pull requestsarrow-up-right
AppCenter Flatpak repositoryarrow-up-right
publish an update
AppCenter Reviews Github repositoryarrow-up-right
io.github.myteam.myapp.json
{
  "source": "https://github.com/danirabbit/harvey.git",
  "commit": "45dd52660c0069207fa4b0c1fcf7ac6d7157d34b",
  "version": "1.0.1"
}
https://github.com/elementary/appcenter-reviews/new/main/applicationsgithub.comchevron-right
Select this link to automatically open a new file in the correct location