{"id":3264,"date":"2010-02-19T18:53:01","date_gmt":"2010-02-19T18:53:01","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/webdev\/2010\/02\/19\/how-to-package-net-assemblies\/"},"modified":"2010-02-19T18:53:01","modified_gmt":"2010-02-19T18:53:01","slug":"how-to-package-net-assemblies","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/dotnet\/how-to-package-net-assemblies\/","title":{"rendered":"How to package .NET assemblies"},"content":{"rendered":"\n\n\n
\n

If we want to package and deploy .NET assemblies for a web application only, we can simply reference them and change their \u201cCopy Local\u201d property to \u201cTrue\u201d.  <\/p>\n

For example, we can do the following to package a MVC project from VS2010.<\/p>\n<\/p>\n

    \n
  1. Create a MVC project <\/li>\n
  2. In its references, change the following three assemblies \u201cCopy Local\u201d property value to True. \n
      \n
    • System.Web.Mvc <\/li>\n
    • System.Web.Routing <\/li>\n
    • System.Web.Abstractions <\/li>\n<\/ul>\n

      You can multi-select them and set the value together. <\/p>\n<\/li>\n

    • Right click the project node and select \u201cBuild Deployment Package\u201d <\/li>\n
    • Examine the package, you will see the above assemblies’ corresponding dll files are included in the package\u2019s bin directory. <\/li>\n<\/ol>\n

       <\/p>\n

      Deploy the above package to a 4.0 site, no matter if the corresponding MVC runtime is installed on the server, your application will simply work fine.<\/p>\n<\/td>\n

\"image\"<\/a> <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

If we want to package and deploy GACed dll, we need to use gacAssembly web deploy provider<\/a> and extend our project similarly to the one stated in the how to package registry blog<\/a>.  The extended projectName.wpp.targets file looks like following:<\/p>\n

 <\/p>\n

<!--<\/span>********************************************************************<\/span>-->\n<!-- <\/span>Task CollectGacAssemblyForPackage \u2013<\/span>>\n<\/span><!-- <\/span>GacAssembly reference: http:\/\/technet.microsoft.com\/en-us\/library\/dd569056(WS.10).aspx <\/span>-->\n<\/span><!--<\/span>********************************************************************<\/span>-->\n<<\/span>Project <\/span>xmlns<\/span>=<\/span>"http:\/\/schemas.microsoft.com\/developer\/msbuild\/2003<\/span>">\n  <<\/span>PropertyGroup<\/span>>\n    <!--<\/span>Targets get execute before this Target<\/span>-->\n    <<\/span>OnBeforeCollectGacAssemblyForPackage <\/span>Condition<\/span>=<\/span>"'$(OnBeforeCollectGacAssemblyForPackage)'==''<\/span>">\n    <\/<\/span>OnBeforeCollectGacAssemblyForPackage<\/span>>\n    <!--<\/span>Targets get execute after this Target<\/span>-->\n    <<\/span>OnAfterCollectGacAssemblyForPackage <\/span>Condition<\/span>=<\/span>"'$(OnAfterCollectGacAssemblyForPackage)'==''<\/span>">\n    <\/<\/span>OnAfterCollectGacAssemblyForPackage<\/span>>\n\n    <<\/span>CollectGacAssemblyForPackageDependsOn <\/span>Condition<\/span>=<\/span>"'$(CollectGacAssemblyForPackageDependsOn)'==''<\/span>">\n      <\/span>$(OnBeforeCollectGacAssemblyForPackage);\n      Build;\n    <\/<\/span>CollectGacAssemblyForPackageDependsOn<\/span>>\n  <\/<\/span>PropertyGroup<\/span>>\n\n  <<\/span>PropertyGroup<\/span>>\n    <<\/span>IncludeGacAssemblyForMyProject <\/span>Condition<\/span>=<\/span>"'$(IncludeGacAssemblyForMyProject)'==''<\/span>"><\/span>False<\/<\/span>IncludeGacAssemblyForMyProject<\/span>>\n    <<\/span>MyGacAssemblies <\/span>Condition<\/span>=<\/span>"'$(MyGacAssemblies)'==''<\/span>"><\/<\/span>MyGacAssemblies<\/span>>\n    <<\/span>AfterAddContentPathToSourceManifest <\/span>Condition<\/span>=<\/span>"'$(AfterAddContentPathToSourceManifest)'==''<\/span>">\n      <\/span>$(AfterAddContentPathToSourceManifest);\n      CollectGacAssemblyForPackage;\n    <\/<\/span>AfterAddContentPathToSourceManifest<\/span>>\n  <\/<\/span>PropertyGroup<\/span>>\n\n  <<\/span>ItemGroup<\/span>>\n    <<\/span>MyGacAssembly <\/span>Include <\/span>= <\/span>"$(MyGacAssemblies)<\/span>"\/>\n  <\/<\/span>ItemGroup<\/span>>\n\n  <<\/span>Target <\/span>Name<\/span>=<\/span>"CollectGacAssemblyForPackage<\/span>"\n          DependsOnTargets<\/span>=<\/span>"$(CollectGacAssemblyForPackageDependsOn)<\/span>"\n          Condition<\/span>=<\/span>"$(IncludeGacAssemblyForMyProject) AND '$(MyGacAssemblies)'!=''<\/span>">\n\n    <<\/span>Message <\/span>Text<\/span>=<\/span>"Adding %(MyGacAssembly.Identity)<\/span>" \/>\n    <<\/span>ItemGroup<\/span>>\n      <<\/span>MsDeploySourceManifest <\/span>Include<\/span>=<\/span>"gacAssembly<\/span>"\n                                 Condition<\/span>=<\/span>"$(IncludeGacAssemblyForMyProject)<\/span>">\n        <<\/span>Path<\/span>><\/span>%(MyGacAssembly.Identity)<\/<\/span>Path<\/span>>\n      <\/<\/span>MsDeploySourceManifest<\/span>>\n    <\/<\/span>ItemGroup<\/span>>\n    <<\/span>CallTarget <\/span>Targets<\/span>=<\/span>"$(OnAfterCollectGacAssemblyForPackage)<\/span>" RunEachTargetSeparately<\/span>=<\/span>"false<\/span>" \/>\n  <\/<\/span>Target<\/span>>\n<\/<\/span>Project<\/span>>\n\n<\/span><\/pre>\n
Then you can use the following command line to package the project with corresponding Mvc GACs and 4.0 version of System.Web.Routing and System.Web.Abstractions.<\/p>\n
msbuild WebApplication2.csproj \/target:package \/p:IncludeGacAssemblyForMyProject=True;MyGacAssemblies="System.Web.Mvc;System.Web.Routing,Version=4.0.0.0;System.Web.Abstractions,Version=4.0.0.0"<\/em><\/p>\n
Note, gacAssembly web deploy provider<\/a> has some limitation as described in the link. <\/p>\n
 <\/p>\n
Xinyang Qiu | Visual Web Developer<\/p>\n","protected":false},"excerpt":{"rendered":"
If we want to package and deploy .NET assemblies for a web application only, we can simply reference them and change their \u201cCopy Local\u201d property to \u201cTrue\u201d.  For example, we can do the following to package a MVC project from VS2010. Create a MVC project In its references, change the following three assemblies \u201cCopy Local\u201d […]<\/p>\n","protected":false},"author":404,"featured_media":58792,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[197],"tags":[7351,7286,7352,7353,7354,7323,7329],"class_list":["post-3264","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-aspnet","tag-gac","tag-mvc","tag-package","tag-target-extension","tag-target-file","tag-visual-studio-2010","tag-web-deployment"],"acf":[],"blog_post_summary":"
If we want to package and deploy .NET assemblies for a web application only, we can simply reference them and change their \u201cCopy Local\u201d property to \u201cTrue\u201d.  For example, we can do the following to package a MVC project from VS2010. Create a MVC project In its references, change the following three assemblies \u201cCopy Local\u201d […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/3264","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/users\/404"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/comments?post=3264"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/3264\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media\/58792"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media?parent=3264"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/categories?post=3264"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/tags?post=3264"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}