{"title":"The MicrosoftApplication.app file","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-application-app-file/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-application-app-file, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-application-app-file","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Learn how the Application app groups Business Central solution dependencies and how to reference it from extensions or a code-customized base application.","date":"2024-01-16","meta":{"topic":"reference"},"outline":[{"level":1,"title":"The Microsoft_Application.app file","slug":"the-microsoft_applicationapp-file","at":0,"chars":5242},{"level":2,"title":"Customize the Application app manifest","slug":"customize-the-application-app-manifest","at":1302,"chars":2298},{"level":2,"title":"Reference the Application app from an extension","slug":"reference-the-application-app-from-an-extension","at":3600,"chars":1371},{"level":2,"title":"Related information","slug":"related-information","at":4971,"chars":271}],"text":"# The Microsoft_Application.app file\nThe `Microsoft_Application_<version>.app` file groups the application dependencies that make up a Business Central solution. Extensions can reference this solution through the application property in app.json instead of declaring separate dependencies on its application packages.\nThe file is included with Business Central in the `\\Applications\\Application\\Source` folder. Its manifest name is Application, even though the package file name includes a publisher and version.\nFor code-customized base applications, an Application app can reference the customized Base Application instead of the Microsoft Base Application. Extensions that use the application property can then resolve their dependencies through that Application app.\n> NOTE\n> The partner who customizes the application must ensure that dependent extensions compile and work. Resolving dependencies doesn't guarantee compatibility with changed application code.\n> IMPORTANT\n> Give the customized Application app its own app ID and publisher. Keep `\"name\": \"Application\"` and `\"propagateDependencies\": true`. Set its version to the Microsoft Base Application version with which the solution is compatible. The Application app's own ID must be distinct from the ID of its Base Application dependency.\n## Customize the Application app manifest\nThe Microsoft Application app references the System Application, Business Foundation, and Base Application. The following example shows the relevant manifest settings.\nThe examples use `29.0.0.0` as an illustrative target version, not as a requirement for every extension. Use the versions and app IDs from your target application packages. The GUIDs and the BusinessFoundationAppId placeholder are example values.\n```json\n{\n    \"id\": \"00001111-aaaa-2222-bbbb-3333cccc4444\",\n    \"name\": \"Application\",\n    \"publisher\": \"Microsoft\",\n    \"version\": \"29.0.0.0\",\n    \"propagateDependencies\": true,\n    \"dependencies\": [\n        {\n            \"id\": \"11112222-bbbb-3333-cccc-4444dddd5555\",\n            \"name\": \"Base Application\",\n            \"publisher\": \"Microsoft\",\n            \"version\": \"29.0.0.0\"\n        },\n        {\n            \"id\": \"22223333-cccc-4444-dddd-5555eeee6666\",\n            \"name\": \"System Application\",\n            \"publisher\": \"Microsoft\",\n            \"version\": \"29.0.0.0\"\n        },\n        {\n            \"id\": \"<BusinessFoundationAppId>\",\n            \"name\": \"Business Foundation\",\n            \"publisher\": \"Microsoft\",\n            \"version\": \"29.0.0.0\"\n        }\n    ]\n}\n```\nTo reference a code-customized base application, change the Base Application dependency's id, name, publisher, and version to match that application's manifest. Keep the other dependencies required by your solution. The following example shows a customized Application app.\n```json\n{\n    \"id\": \"00001111-aaaa-2222-bbbb-3333cccc4444\",\n    \"name\": \"Application\",\n    \"publisher\": \"Fabrikam\",\n    \"version\": \"29.0.0.0\",\n    \"propagateDependencies\": true,\n    \"dependencies\": [\n        {\n            \"id\": \"11112222-bbbb-3333-cccc-4444dddd5555\",\n            \"name\": \"Customized Base Application\",\n            \"publisher\": \"Fabrikam\",\n            \"version\": \"29.0.0.0\"\n        },\n        {\n            \"id\": \"22223333-cccc-4444-dddd-5555eeee6666\",\n            \"name\": \"System Application\",\n            \"publisher\": \"Microsoft\",\n            \"version\": \"29.0.0.0\"\n        },\n        {\n            \"id\": \"<BusinessFoundationAppId>\",\n            \"name\": \"Business Foundation\",\n            \"publisher\": \"Microsoft\",\n            \"version\": \"29.0.0.0\"\n        }\n    ]\n}\n```\n## Reference the Application app from an extension\nUse the application property to specify the minimum application version that your extension supports. Remove direct dependencies on the Microsoft Base Application and System Application from dependencies. Learn more about manifest settings in devenv-json-files.\nThe Application app propagates its dependencies to your extension. This abstraction reduces the dependency changes needed when a solution moves functionality between application packages. It can also support code-customized on-premises applications and Embed App solutions, provided that those solutions remain compatible with your extension.\nYour extension's own version is separate from its minimum application version, as shown in this example.\n```json\n{\n    \"id\": \"00001111-aaaa-2222-bbbb-3333cccc4444\",\n    \"name\": \"Fabrikam Gadgets Management\",\n    \"publisher\": \"Fabrikam\",\n    \"version\": \"1.0.0.0\",\n    \"application\": \"29.0.0.0\",\n    \"dependencies\": []\n}\n```\n> IMPORTANT\n> Marketplace apps must specify the application property. AppSourceCop reports AS0100 when the property is missing for runtime 4.3 or later. It reports AS0085 when an app declares explicit dependencies on the Microsoft Base Application or System Application. See AppSourceCop rule AS0100<analyzers/appsourcecop-as0100> and AppSourceCop rule AS0085<analyzers/appsourcecop-as0085>.\n## Related information\ndevenv-json-files\nAppSourceCop rule AS0100<analyzers/appsourcecop-as0100>\nAppSourceCop rule AS0085<analyzers/appsourcecop-as0085>\nInstall an update<../upgrade/upgrading-cumulative-update-v15>\nUnderstand app identity for AL apps<devenv-app-identity>"}