Release management
The Release Management section of the Developers console allows you to manage your app releases. There are two kinds of releases:
- Testing—the release channel for pre-release apps that needs to be tested by users prior to deployment.
- Production—the release channel where you upload qualified and tested versions of your app to the App Store.
Testing channel
The Testing channel provides a place for you to manage pre-release versions of your app for testing purposes. It is divided into sub-channels so that you can manage the different versions that need to be tested. You can create and manage up to 10 test channels.
For more information on managing your testing channels, see Managing a testing channel.
Production channel
The Production channel is used to manage the versions of software that have passed the testing phase and are ready for deployment. This channel is a public facing channel and is the default for users to download your app from the App Store.
- New Release—upload a new app version.
- Public Releases—manage the currently live versions in the channel.
- Release History—manage past app versions.
Each of the tables contains the Version details.
The Version details table contains following columns:
- Version—the app version associated with this version.
- Uploaded—when was this version uploaded.
- Rollout (Only in the active versions table)—the current rollout status of this version. Possible values include:
- Download size—the size of the raw
.opk
file for this version. - Installs—how many (non-unique) installations of this version have ever occurred.
- Active Installs—how many active installations exist for this version (the last 30 days).
- Direct download—directly download the app.
When you open a line item from the Version details, you can edit the internal notes or add release notes.
New release pane
The New Release pane is where you upload a new version of your app. Make sure you have a valid .opk
file for the new version. For more information about creating a new .opk
file, see how to create an .opk
package.
Dragging an .opk
file (or pressing Upload
and selecting one), creates a new version release called draft.
Once the .opk
file has completed the upload, you will see a Release Review screen where you can make adjustments to the release of the app.
- Mandatory version reviews may not be needed once your app is deemed stable after several version reviews. If you don't have mandatory reviews, then you can skip directly to the Release rollout percentage to start your rollout.
- Test Channels are always exempt from mandatory version reviews.
- It is recommended to submit major versions for review, even if reviews are no longer mandatory.
Add internal release notes for this version by pressing Add internal notes. Internal release notes will only be viewable by your app's team, and the Overwolf team.
Once the release notes are added, the screen will change and start the review process for the new version.
Press Submit
to send the app for review by the Overwolf team. If at any point, you wish to pull the review back, press Cancel Request
.
The release process begins once the version is approved.
Production
Use Add release notes to add public release notes to your approved production version. Then the rollout % can be specified in the relevant textbox. Press Start rollout to start the rollout.
Press Confirm to release the version from draft mode. It then becomes a full release, and can be found in Public Releases.
At any point throughout the process you can decide to discard this version's draft. To delete the draft version, press Discard release.
Press Confirm to finish deleting the draft version.
Public Releases pane
The Public Releases pane is where you manage the current active versions.
You can only change the rollout percentage of the latest version of the app.
- Opened
- Closed
Enter a new number to change the percentage for versions that have not been rolled out completely, then press Increase.
Release rollout percentage
This section only appears for a Phasing version and won't appear for any other version.
Release rollout percentage
Release History pane
The Release History pane is where you manage the previous released versions of your app.
Previous versions are split into pages using The Paging Footer.
- Opened
- Closed
You can browse the different pages of older releases (in the bottom right) as well as see a total of all versions. You can change the amount displayed per page (in the bottom left).
Release notes
There are two kinds of version release notes:
- Internal release notes—used for documenting all changes done to the app over time. They can only be viewed by your app's staff and the Overwolf team.
- Public release notes—your app's public release notes for documenting public changes to the app. They can be viewed by anyone, even outside of the developer's console. It is recommended to use them to manage your app's public changelog for new versions.
To edit release notes, press on a release in the table, then press the edit buttons. Release notes are edited in the text editor using CommonMark. You can also use the Editing tools in the editor's top toolbar.
Use the Cancel
and Save
buttons in the editor to discard or save your changes (similar to The Footer Toolbar).
Public release notes also contain toggles:
- Publish—enable the toggle to publish the release notes so that any changes made will be available for everyone to read. Disable the toggle to create a draft for your new version. For release notes you wish to keep internal, use the
Internal release notes
instead. - Important—label this version as
important
. Typically used to mark major versions or time-critical updates.
Changes made to the public release notes of an app will take approximately 5 minutes to update. Use the release notes endpoint to verify that they have been updated.
Release notes endpoint
The developer's console exposes a compiled HTML of pubic release notes for every app through the following API endpoint:
`https://console-api.overwolf.com/v1/apps/${app-id}/versions/${version}/release-notes/${page}`
Replace:
app-id
—with your app's unique id.version
— with the most recent version you wish to display.page
—with the changelogs page number. Every page contains up to three changelogs.
The endpoint returns the following json:
{
"versions": [
{
"important": boolean,
"version": string,
"html": string,
"timestamp": number
}
],
"meta": {
"perPage": number
}
}
Any version without a published
public changelog will be skipped.
The versions
array contains up to three versions.
what does this mean? If it runs out of versions to display before then, it will only be filled by the remaining versions. In the next page after that, it will then be completely empty.
Changelog page numbers start from 1. If you check for page 0, it will just be treated as page 1.
Example Values
For example:
app-id
—npijmgiaiiemcnijaljcfddgeihcbifdbhpffihe
version
—6.0.71
The link looks like:
`https://console-api.overwolf.com/v1/apps/npijmgiaiiemcnijaljcfddgeihcbifdbhpffihe/versions/6.0.71/release-notes/${page}`
This example includes three versions with release notes.
- Page 0
- Page 1
- Page 2
The result for page 0 would be:
{
"versions":[
{
"important":true,
"version":"6.0.69",
"html":"<p>test</p>",
"timestamp":1662018568162
},
{
"important":true,
"version":"3.1.5",
"html":"<figure><img src='http://content.overwolf.com/outplayed/release-notes/069/release-notes-hero.webp'></figure>\n<p><strong>All versions great and small.</strong> This version might be small, but still bright and beautiful.</p>\n<h2 class='new'>New</h2>\n<ul>\n<li><strong>5 new games are now supported</strong> - Rayman Origins, Post Scriptum, South Park: The Stick of Truth, Shadow Tactics: Blades of the Shogun, and Firewatch. Want us to add your favorite game? Let us know on our <a href=\"https://ideas.outplayed.tv/\">Ideas portal</a>.</li>\n<li><strong>Capture mode notification</strong> - An option to turn capture OFF was added. If this option is selected, Outplayed will be disabled for this game, choose wisely (you can always enable it back from the settings).</li>\n</ul>\n<h2 class='improved'>Better</h2>\n<ul>\n<li><strong>Missing backgrounds</strong> - Remnant: From the Ashes and Project Zomboid artwork was added.</li>\n<li><strong>Settings in-game</strong> - Did you know that changing settings while in-game will only take effect after restarting the game? A big yellow alert was added to make sure you know.</li>\n</ul>\n<h2 class='bugs'>Fixed</h2>\n<ul>\n<li><strong>Capture mode notification</strong> - Allow using numeric keypad in the notification hotkeys. We like hotkeys, especially in the winter.</li>\n<li><strong>Video editor</strong> - Videos with aspect ratios different than project settings were stretched to fit. Although stretching is good for your health, we fixed it.</li>\n</ul>\n<p>Have a great idea for Outplayed? Let us know on our <a href=\"https://ideas.outplayed.tv/\">Ideas portal</a>, or talk to us directly on our <a href=\"https://discord.gg/MatrVYK\">Discord server</a>.</p>\n<p><strong>See you in the next version,<br>\nThe Outplayed team</strong></p>",
"timestamp":1643024580643
},
{
"important":false,
"version":"3.0.33",
"html":"<p>3.0.33 release notessssssss</p>",
"timestamp":1643036589211
}
],
"meta":{
"perPage":3
}
}
Which is the same as the result for page 1.
The result for page 1 would be:
{
"versions":[
{
"important":true,
"version":"6.0.69",
"html":"<p>test</p>",
"timestamp":1662018568162
},
{
"important":true,
"version":"3.1.5",
"html":"<figure><img src='http://content.overwolf.com/outplayed/release-notes/069/release-notes-hero.webp'></figure>\n<p><strong>All versions great and small.</strong> This version might be small, but still bright and beautiful.</p>\n<h2 class='new'>New</h2>\n<ul>\n<li><strong>5 new games are now supported</strong> - Rayman Origins, Post Scriptum, South Park: The Stick of Truth, Shadow Tactics: Blades of the Shogun, and Firewatch. Want us to add your favorite game? Let us know on our <a href=\"https://ideas.outplayed.tv/\">Ideas portal</a>.</li>\n<li><strong>Capture mode notification</strong> - An option to turn capture OFF was added. If this option is selected, Outplayed will be disabled for this game, choose wisely (you can always enable it back from the settings).</li>\n</ul>\n<h2 class='improved'>Better</h2>\n<ul>\n<li><strong>Missing backgrounds</strong> - Remnant: From the Ashes and Project Zomboid artwork was added.</li>\n<li><strong>Settings in-game</strong> - Did you know that changing settings while in-game will only take effect after restarting the game? A big yellow alert was added to make sure you know.</li>\n</ul>\n<h2 class='bugs'>Fixed</h2>\n<ul>\n<li><strong>Capture mode notification</strong> - Allow using numeric keypad in the notification hotkeys. We like hotkeys, especially in the winter.</li>\n<li><strong>Video editor</strong> - Videos with aspect ratios different than project settings were stretched to fit. Although stretching is good for your health, we fixed it.</li>\n</ul>\n<p>Have a great idea for Outplayed? Let us know on our <a href=\"https://ideas.outplayed.tv/\">Ideas portal</a>, or talk to us directly on our <a href=\"https://discord.gg/MatrVYK\">Discord server</a>.</p>\n<p><strong>See you in the next version,<br>\nThe Outplayed team</strong></p>",
"timestamp":1643024580643
},
{
"important":false,
"version":"3.0.33",
"html":"<p>3.0.33 release notessssssss</p>",
"timestamp":1643036589211
}
],
"meta":{
"perPage":3
}
}
Which is the same as the result for page 0.
The result for page 2 would be:
{
"versions":[
],
"meta":{
"perPage":3
}
}
Which is empty, since there are only 3 published release notes from this version.
App Channels sample app
For an example of how to utilize app channels, download the App Channels sample app.