{"_id":"591f17b021d2ff0f00cf5a4a","category":{"_id":"591f17af21d2ff0f00cf5a41","__v":0,"project":"547cd7662eaee50800ed1089","version":"591f17ae21d2ff0f00cf5a3f","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-07-21T09:47:49.247Z","from_sync":false,"order":1,"slug":"getting-started-windows-framework","title":"Get Started: Windows Apps"},"user":"547cd6ac78fd57080023ca99","version":{"_id":"591f17ae21d2ff0f00cf5a3f","__v":1,"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"},"parentDoc":null,"project":"547cd7662eaee50800ed1089","__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-21T12:32:13.945Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":14,"body":"1. Add a reference to the DevMateKit.dll into your project.\n2. Assign values to the `DMFrameworkSettings` properties (note that all properties must be declared):\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"DMFrameworkSettings.CompanyName = \\\"CompanyName\\\";\\nDMFrameworkSettings.ApplicationName = \\\"ApplicationName\\\";\\nDMFrameworkSettings.ApplicationBundleId = \\\"com.application.name\\\"; \\nDMFrameworkSettings.ApplicationVersion = \\\"1.0.0\\\";\\nDMFrameworkSettings.Localization = \\\"en\\\";\",\n      \"language\": \"csharp\"\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"`CompanyName`\",\n    \"0-1\": \"Name of your company. A value cannot be null or empty.\",\n    \"1-0\": \"`ApplicationName`\",\n    \"1-1\": \"Name of your application. A value cannot be null or empty.\",\n    \"2-0\": \"`ApplicationBundleId`\",\n    \"2-1\": \"Bundle ID of your application. You specify it on the DevMate Dashboard when you add an application. A value cannot be null or empty. Example: *com.application.name*.\",\n    \"3-0\": \"`ApplicationVersion`\",\n    \"3-1\": \"Current version of the application. Must contain two to four integer numbers divided by point. Example: *1.0*, *1.0.0*, or *1.0.0.0*.\",\n    \"4-0\": \"`Localization`\",\n    \"4-1\": \"Languages of the application UI and exceptions. DevMate supports the following languages: \\\"de\\\", \\\"en\\\", \\\"es-ES\\\", \\\"fr\\\", \\\"it\\\", \\\"ja\\\", \\\"pl\\\", \\\"pt-br\\\", \\\"ru\\\" (case insensitive). If a set language is similar to any of the listed ones, DevMate accepts it but uses the most appropriate supported language. For example, \\\"fr-FR\\\" uses “fr”, while \\\"pt\\\" uses “pt-BR”.\"\n  },\n  \"cols\": 2,\n  \"rows\": 5\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Configure Tracking\"\n}\n[/block]\n1. Add the `IsFirstRun` property to `DMFrameworkSettings`:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"DMFrameworkSettings.IsFirstRun = false;\",\n      \"language\": \"csharp\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"On first clean run of the application, the `IsFirstRun` property must be set to “true”. In this case, DevMate will receive a report from the application that contains data on the first actual launch of the app. This command is needed to be run once. \\n\\nPurpose of this property with the \\\"false\\\" value is not to launch DevMate Kit for the application first run, postponing it to the second run. For example in case when you need to perform basic installation and restart application immediately after that.\",\n  \"title\": \"NOTE\"\n}\n[/block]\n2. Call the following method after assigning values to `DMFrameworkSettings`: \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"TrackingFramework.Current.ApplicationStarted();\",\n      \"language\": \"csharp\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"integrate-devmatekit","type":"basic","title":"Integrate DevMateKit"}

Integrate DevMateKit


1. Add a reference to the DevMateKit.dll into your project. 2. Assign values to the `DMFrameworkSettings` properties (note that all properties must be declared): [block:code] { "codes": [ { "code": "DMFrameworkSettings.CompanyName = \"CompanyName\";\nDMFrameworkSettings.ApplicationName = \"ApplicationName\";\nDMFrameworkSettings.ApplicationBundleId = \"com.application.name\"; \nDMFrameworkSettings.ApplicationVersion = \"1.0.0\";\nDMFrameworkSettings.Localization = \"en\";", "language": "csharp" } ] } [/block] [block:parameters] { "data": { "h-0": "Property", "h-1": "Description", "0-0": "`CompanyName`", "0-1": "Name of your company. A value cannot be null or empty.", "1-0": "`ApplicationName`", "1-1": "Name of your application. A value cannot be null or empty.", "2-0": "`ApplicationBundleId`", "2-1": "Bundle ID of your application. You specify it on the DevMate Dashboard when you add an application. A value cannot be null or empty. Example: *com.application.name*.", "3-0": "`ApplicationVersion`", "3-1": "Current version of the application. Must contain two to four integer numbers divided by point. Example: *1.0*, *1.0.0*, or *1.0.0.0*.", "4-0": "`Localization`", "4-1": "Languages of the application UI and exceptions. DevMate supports the following languages: \"de\", \"en\", \"es-ES\", \"fr\", \"it\", \"ja\", \"pl\", \"pt-br\", \"ru\" (case insensitive). If a set language is similar to any of the listed ones, DevMate accepts it but uses the most appropriate supported language. For example, \"fr-FR\" uses “fr”, while \"pt\" uses “pt-BR”." }, "cols": 2, "rows": 5 } [/block] [block:api-header] { "type": "basic", "title": "Configure Tracking" } [/block] 1. Add the `IsFirstRun` property to `DMFrameworkSettings`: [block:code] { "codes": [ { "code": "DMFrameworkSettings.IsFirstRun = false;", "language": "csharp" } ] } [/block] [block:callout] { "type": "info", "body": "On first clean run of the application, the `IsFirstRun` property must be set to “true”. In this case, DevMate will receive a report from the application that contains data on the first actual launch of the app. This command is needed to be run once. \n\nPurpose of this property with the \"false\" value is not to launch DevMate Kit for the application first run, postponing it to the second run. For example in case when you need to perform basic installation and restart application immediately after that.", "title": "NOTE" } [/block] 2. Call the following method after assigning values to `DMFrameworkSettings`: [block:code] { "codes": [ { "code": "TrackingFramework.Current.ApplicationStarted();", "language": "csharp" } ] } [/block]