{"category":{"version":"591f17ae21d2ff0f00cf5a3f","project":"547cd7662eaee50800ed1089","_id":"591f17af21d2ff0f00cf5a40","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-12-01T21:02:31.346Z","from_sync":false,"order":0,"slug":"start","title":"Get Started: Mac OS Apps"},"parentDoc":null,"project":"547cd7662eaee50800ed1089","user":"573dd709b3f88f0e00dcae1f","version":{"__v":1,"_id":"591f17ae21d2ff0f00cf5a3f","project":"547cd7662eaee50800ed1089","createdAt":"2017-05-19T16:05:02.775Z","releaseDate":"2017-05-19T16:05:02.775Z","categories":["591f17af21d2ff0f00cf5a40","591f17af21d2ff0f00cf5a41","591f17af21d2ff0f00cf5a42","591f17af21d2ff0f00cf5a43","591f17af21d2ff0f00cf5a44","591f17af21d2ff0f00cf5a45","591f17af21d2ff0f00cf5a46","591f17af21d2ff0f00cf5a47","591f17af21d2ff0f00cf5a48"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.1","version":"1.0.1"},"_id":"591f17b021d2ff0f00cf5a55","__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-08T11:28:39.972Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":4,"body":"After you integrated DevMate Kit, you can add the first version of your application:\n1. Open the Applications tab of your DevMate account and click on your application in the list that appears.\n2. Navigate to the Release Management tab by clicking a corresponding item in the DevMate's left-side pane. \n3. Click the Add New Application Version button. The Add New Version wizard will help you to create a new version of your app. \n\nThere are the following fields available in the Advanced mode:\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"Status\",\n    \"0-1\": \"Draft / Testing / Live\",\n    \"0-2\": \"The status that is related to a new version. It is always set to Draft when a new version is added for the first time. \\nPlease Edit newly added Release to change the app's status.\",\n    \"h-2\": \"Comments\",\n    \"h-1\": \"Choice\",\n    \"h-0\": \"Name\",\n    \"1-0\": \"Bundle version\",\n    \"1-1\": \"CFBundleVersion key from your app\",\n    \"2-0\": \"Short Bundle Version\",\n    \"2-1\": \"CFBundleShortVersionString key from your app\",\n    \"1-2\": \"The key from Xcode and info.plist. It is important because the Updates Framework refers to this key. Requires a \\\"letter\\\" to consider version as a Beta.\",\n    \"2-2\": \"The key from Xcode and info.plist. It is important as the Updates Framework refers to this key. Requires a \\\"letter\\\" to consider version as a Beta.\",\n    \"3-0\": \"Version Codename\",\n    \"3-1\": \"Any code name you want to add to your app\",\n    \"3-2\": \"Internal setting that is visible only in Release Management.\",\n    \"4-0\": \"Release date\",\n    \"4-1\": \"Exact date choice\",\n    \"4-2\": \"Defined date of the app release.\",\n    \"5-0\": \"OS Limitation\",\n    \"5-1\": \"Control lowest OS X version the app is available to\",\n    \"5-2\": \"Not required. Can be set to make an app support only specific OS versions, starting from the specified one (minimum required OS X version).\",\n    \"6-0\": \"Update Method\",\n    \"6-1\": \"Either a regular In-app update or External update\",\n    \"6-2\": \"DevMate supports not only regular updates via Update Framework but also External Updates via external link.\",\n    \"7-0\": \"Release Files\",\n    \"7-1\": \"ZIP, DMG and .dSYM.ZIP\",\n    \"7-2\": \"All three files are needed to distribute them to customers and use dSYM for the crashes de-symbolication.\",\n    \"8-0\": \"Release Notes\",\n    \"8-1\": \"Release Notes of your app\",\n    \"8-2\": \"An overview of changes and enhancements made to the application in the current update. Displayed to users of your app.\",\n    \"9-0\": \"Add Localization Notes\",\n    \"9-1\": \"Localized Release Notes\",\n    \"9-2\": \"A way to add different release notes for different localizations of the app.\"\n  },\n  \"cols\": 3,\n  \"rows\": 10\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Why keeping a correct version is important\",\n  \"body\": \"While adding a new version, please pay attention to both **Bundle Version** and **Short Bundle Version** strings. If they don't coincide with the strings in the app's info.plist, the app may not see the update available in the Release Management.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Managing Beta versions\",\n  \"body\": \"While creating a beta version of the app, please add letters to emphasise it. Otherwise, the version will be considered regular one. When the letter is added, DevMate shows \\\"ß-letter\\\" next to the app version and its status. It is also shown in the Beta Update Feed while checking for the updates.\\n\\nNote: Make sure you've configured the Updater to check for the Beta Updates. To find out more, read [Updates](https://docs.devmate.com/docs/updates) article.\"\n}\n[/block]","excerpt":"","slug":"add-new-application-version","type":"basic","title":"Add a New App Version"}

Add a New App Version


After you integrated DevMate Kit, you can add the first version of your application: 1. Open the Applications tab of your DevMate account and click on your application in the list that appears. 2. Navigate to the Release Management tab by clicking a corresponding item in the DevMate's left-side pane. 3. Click the Add New Application Version button. The Add New Version wizard will help you to create a new version of your app. There are the following fields available in the Advanced mode: [block:parameters] { "data": { "0-0": "Status", "0-1": "Draft / Testing / Live", "0-2": "The status that is related to a new version. It is always set to Draft when a new version is added for the first time. \nPlease Edit newly added Release to change the app's status.", "h-2": "Comments", "h-1": "Choice", "h-0": "Name", "1-0": "Bundle version", "1-1": "CFBundleVersion key from your app", "2-0": "Short Bundle Version", "2-1": "CFBundleShortVersionString key from your app", "1-2": "The key from Xcode and info.plist. It is important because the Updates Framework refers to this key. Requires a \"letter\" to consider version as a Beta.", "2-2": "The key from Xcode and info.plist. It is important as the Updates Framework refers to this key. Requires a \"letter\" to consider version as a Beta.", "3-0": "Version Codename", "3-1": "Any code name you want to add to your app", "3-2": "Internal setting that is visible only in Release Management.", "4-0": "Release date", "4-1": "Exact date choice", "4-2": "Defined date of the app release.", "5-0": "OS Limitation", "5-1": "Control lowest OS X version the app is available to", "5-2": "Not required. Can be set to make an app support only specific OS versions, starting from the specified one (minimum required OS X version).", "6-0": "Update Method", "6-1": "Either a regular In-app update or External update", "6-2": "DevMate supports not only regular updates via Update Framework but also External Updates via external link.", "7-0": "Release Files", "7-1": "ZIP, DMG and .dSYM.ZIP", "7-2": "All three files are needed to distribute them to customers and use dSYM for the crashes de-symbolication.", "8-0": "Release Notes", "8-1": "Release Notes of your app", "8-2": "An overview of changes and enhancements made to the application in the current update. Displayed to users of your app.", "9-0": "Add Localization Notes", "9-1": "Localized Release Notes", "9-2": "A way to add different release notes for different localizations of the app." }, "cols": 3, "rows": 10 } [/block] [block:callout] { "type": "warning", "title": "Why keeping a correct version is important", "body": "While adding a new version, please pay attention to both **Bundle Version** and **Short Bundle Version** strings. If they don't coincide with the strings in the app's info.plist, the app may not see the update available in the Release Management." } [/block] [block:callout] { "type": "info", "title": "Managing Beta versions", "body": "While creating a beta version of the app, please add letters to emphasise it. Otherwise, the version will be considered regular one. When the letter is added, DevMate shows \"ß-letter\" next to the app version and its status. It is also shown in the Beta Update Feed while checking for the updates.\n\nNote: Make sure you've configured the Updater to check for the Beta Updates. To find out more, read [Updates](https://docs.devmate.com/docs/updates) article." } [/block]