flutter>> MultiTargetingProject>> 返回
项目作者： GeertvanHorrik

项目描述 ：
Example repository of a multi-targeting project build Cake build scripts to build and code-sign both assemblies *and* NuGet packages
高级语言： C#
项目地址: git://github.com/GeertvanHorrik/MultiTargetingProject.git
创建时间： 2018-03-14T14:05:06Z
项目社区：https://github.com/GeertvanHorrik/MultiTargetingProject
开源协议：Other
下载


MultiTargetingProject

This is an example repository on how to target .NET 4.6, .NET 4.7 and UAP 10.0 using a single project.

This project has been written as an example for the blog post about multi-targeting platforms with a single project.

Along the way, this example has been expanded with the following new Cake build scripts:

  • Build multi-targeting class libraries (components)
  • Build WPF apps
  • Build UWP apps
  • Build Chocolatey tools
  • Build GitHub pages
  • Build web apps (Octopus Deploy and Azure Web Apps)
  • Build docker images

The scripts are set up in a way that allows a combination of these items as well (e.g. a WPF with an API library) can all be set up. For more information, see the RepositoryTemplate repository.

How to build this example

  1. Open powershell with the repository as working directory
  2. .\build.ps1 -target package

How does it work?

The scripts are extremely generic. One only has to customize 1 file:

  • /build.cake

Below is an example script to package a (multi-targeting) component, wpf and uwp app in a single solution:

  1. //=======================================================
  2. // DEFINE PARAMETERS
  3. //=======================================================
  5. // Define the required parameters
  6. var Parameters = new Dictionary<string, object>();
  7. Parameters["SolutionName"] = "Ghk.MultiTargeting";
  8. Parameters["Company"] = "Geert van Horrik";
  9. Parameters["RepositoryUrl"] = string.Format("https://github.com/GeertvanHorrik/{0}",  GetBuildServerVariable("SolutionName"));
  10. Parameters["StartYear"] = "2018";
  11. Parameters["UseVisualStudioPrerelease"] = "true";
  13. // Note: the rest of the variables should be coming from the build server,
  14. // see `/deployment/cake/*-variables.cake` for customization options
  15. // 
  16. // If required, more variables can be overridden by specifying them via the 
  17. // Parameters dictionary, but the build server variables will always override
  18. // them if defined by the build server. For example, to override the code
  19. // sign wild card, add this to build.cake
  20. //
  21. // Parameters["CodeSignWildcard"] = "Orc.EntityFramework";
  23. //=======================================================
  24. // DEFINE COMPONENTS TO BUILD / PACKAGE
  25. //=======================================================
  27. Components.Add("Ghk.MultiTargeting");
  28. Tools.Add("Ghk.MultiTargeting.Tool");
  29. WpfApps.Add("Ghk.MultiTargeting.Example.Wpf");
  30. UwpApps.Add("Ghk.MultiTargeting.Example.Uwp");
  31. TestProjects.Add("Ghk.Multitargeting.Tests");
  33. // Not included:
  34. // DockerImages.Add("Ghk.MultiTargeting.DockerImage");
  35. // WebApps.Add("Ghk.MultiTargeting.WebApp");
  36. // GitHubPages.Add("Ghk.MultiTargeting.GitHubPages");
  38. //=======================================================
  39. // REQUIRED INITIALIZATION, DO NOT CHANGE
  40. //=======================================================
  42. // Now all variables are defined, include the tasks, that
  43. // script will take care of the rest of the magic
  45. #l "./deployment/cake/tasks.cake"

And if you are not using a build server (seriously, you should be), you could choose to customize /deployment/cake/*-variables.cake as well.

The Cake magic happens in the generic scripts in /deployment/cake/*.cake

How to use the scripts

Below are a few example targets using exactly the same scripts:

Script Description
./build.ps1 -Target BuildWpfApps Build all WPF apps in the solution
./build.ps1 -Target Package Build & package all components & (WPF & UWP) apps in the solution
./build.ps1 -Target PackageComponents Build & package all components in the solution
./build.ps1 -Target PackageUwpApps Build & package all UWP apps in the solution

As you can see, there is a pattern:

  • Build[SpecificTarget]
  • Package[SpecificTarget]

Note that [SpecificTarget] is optional

Project differences compared to the original template

Compared to the original multi-targeting example, the following changes were made.

Project defines

To make sure I could still use the defines we invested in (to maximize code-sharing, we use a lot of #if in code shared between WPF and UWP). This project creates the following defines:

  • .NET 4.6 => NET; NET46
  • .NET 4.7 => NET; NET47
  • UAP 10.0 => UAP; NETFX_CORE
  • .NET Standard 2.0 => NS; NS20; NETSTANDARD; NETSTANDARD2_0

Include solution assembly info

The project structure adds this line to the project to include the SolutionAssemblyInfo and GlobalSuppressions files which are in the root of the solution.

  1. <Compile Include="..\*.cs" ></Compile>

Allow shared code-behind (e.g. MyView.xaml.cs) with a per platform view (e.g. MyView.xaml)

To allow sharing of code-behind of a view (for example, for custom controls), we need to to a bit of hacking. We create the view inside each platform specific view directory:

  • Platforms\net\Views\MyView.xaml (+ .cs)
  • Platforms\uap10.0\Views\MyView.xaml (+ .cs)

After creating the views, one will need to customize the code-behind to add a partial method:

  1. public partial class MyView
  2. {
  3.      public MyView()
  4.      {
  5.          InitializeComponent();
  7.          Construct();
  8.      }
  10.      partial void Construct();
  11. }

Next, create a partial code-behind class inside the regular views folder that contains the shared code:

  • Views\MyView.xaml.cs

This view should contain the following code and allows sharing code-behind but have per-platform xaml files:

  1. public partial class MyView
  2. {
  3.      partial void Construct()
  4.      {
  5.          // TODO: Add shared constructor info here
  6.      }
  7. }

As an example, a dependency property is added in the shared code-behind that shows how to deal with the different platforms in shared code using defines.

Credits