(1/2) 为了理解 UWP 的启动流程，我从零开始创建了一个 UWP 程序-白红宇

原文:

版权声明：本作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。欢迎转载、使用、重新发布，但务必保留文章署名吕毅（包含链接：http://blog.csdn.net/wpwalter/），不得用于商业目的，基于本文修改后的作品务必以相同的许可发布。如有任何疑问，请与我联系（walter.lv@qq.com）。 https://blog.csdn.net/WPwalter/article/details/81230328

每次使用 Visual Studio 的模板创建一个 UWP 程序，我们会在项目中发现大量的项目文件、配置、应用启动流程代码和界面代码。然而这些文件在 UWP 程序中到底是如何工作起来的？

我从零开始创建了一个 UWP 程序，用于探索这些文件的用途，了解 UWP 程序的启动流程。

本文分为两个部分：

本文将一个普通项目改造成 UWP 项目，重点在了解 UWP 的项目文件组成。

从最简单的项目模板开始

虽然可以从零开始写一个 csproj 文件，不过这并没有什么技术含量，因为新的 csproj 文件实在是非常简单。参见：

于是，我创建一个 .NET Core 控制台应用。当然，其它简单的如 .NET Standard 库都是一样的，反正最后都会被我改得面目全非。

创建 .NET Core 控制台应用

于是我得到了一个 csproj 项目文件和包含有应用程序入口的 Program.cs 文件。

两个文件

其中 csproj 文件内容非常简单：


       
          
       
        Exe
           
       
        netcoreapp2.1

Program.cs 文件也是：

// using System;namespace Walterlv.Demo.ZeroUwp{
         class Program    {
             static void Main(string[] args)        {            // 这一句需要删除，因为 UWP 程序中不能使用控制台。            // Console.WriteLine("Hello World!");        }    }}

不过，这两个文件都会被改掉的，已经无所谓里面是什么内容了。

将项目改造成 UWP 项目

UWP 程序的输出类型是 AppContainerExe，而不是一般的 Library 或者 Exe。

另外，基于 Microsoft.NET.Sdk 的新 csproj 格式不支持 UWP 应用程序。所以我希望借助第三方的 MSBuild.Sdk.Extras 来编译 UWP 的项目。参见。

然而实际情况也不容乐观，因为此第三方 Sdk 只支持 UWP 的库程序，而不支持应用程序容器。所以即便修改为以下方式，最终也因为缺少 Visual Studio RunCommand 的支持，而导致无法启动。


       
          
       
        AppContainerExe
           
       
        uap10.0.17134

使用以上新 Sdk 的 csproj 格式，我完整地写完了整个 csproj 文件和后续步骤，依然无法解决下面这个错误提示框：

RunCommand Property is not defined

▲ 无法启动

所以我们依然只能使用传统的 csproj 文件格式。里面大部分的内容从模板中复制而来。事实上，我寻找了很多资料，都没有找到让支持 Sdk 的新 csproj 格式支持 UWP 的主程序。


     
       
        
          
       
        Debug
           
       
        x86
           
       
        {09A58639-DC50-41C1-8BCE-A2217A1D3327}
           
       
        AppContainerExe
           
       
        Properties
           
       
        Walterlv.Demo.ZeroUwp
           
       
        Walterlv.Demo.ZeroUwp
           
       
        en-US
           
       
        UAP
           
       
        10.0.17134.0
           
       
        10.0.15063.0
           
       
        14
           
       
        512
           
       
        {A5A43C5B-DE2A-4C0C-9213-0A381AF9435A};{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}
           
       
        true
           
       
        true
           
       
        bin\x86\Debug\
           
       
        DEBUG;TRACE;NETFX_CORE;WINDOWS_UWP
           
       
        full
           
       
        x86
           
       
        false
           
       
        prompt
           
       
        true
         
        
          
       
        PackageReference
         
        
          
           
         
        
          
             
        
         Designer
            
         
        
          
             
        
         6.1.5
            
         
        
          
       
        14.0

编写 AppxManifest

项目改造成 UWP 项目后，似乎已经完成了大部分了，但此时直接运行会有编译错误，因为我缺少 UWP 程序必要的 AppxManifest.xml 文件。

缺少 AppxManifest.xml 文件

事实上，AppxManifest.xml 的创建是非常繁琐的；通常是编译过程帮我们根据 Package.appxmanifest 文件自动生成的。然而创建一个 Package.appxmanifest 也是很麻烦的。至少，要让 Visual Studio 能够直接打开这个文件所需的最小代码量是下面这些（不能编译通过）：


     
       
        
        
          
       
        Walterlv.ZeroUwp
           
       
        walterlv
           
       
        Assets\StoreLogo.png

可以阅读这些文档了解如何完成这份文件的编写：

具体来说，<Identity /> 是此程序包的标识符，需要在整个应用商店范围内唯一（如果将此包与应用商店关联，这个值会自动更新，所以不用在意填成什么）。<mp:PhoneIdentity /> 是此程序包在移动设备上的标识符，应用的更新会依据此标识符的 GUID 来唯一确定，格式必须是 GUID。

事实上，虽然依然无法完成编译，但此时可以通过在 Visual Studio 中打开这份文件来观察还缺少哪些必要的信息需要填写。

填写缺少的信息

事实上，我们缺少的信息并不多，只有四个，都从 Package/Applications/Application 开始：

uap:VisualElements@Description

uap:VisualElements@BackgroundColor

uap:VisualElements@Square150x150Logo

uap:VisualElements@Square44x44Logo

uap:VisualElements/uap:DefaultTile@Wide310x150Logo

这是 XPath 语法，详见：

同时，我们还真的需要相应的图片：

UWP 程序所需的最少 Logo

建议从 UWP 程序模板中复制，也可以去这里下载：。

补充完毕之后，完整的文件如下：


     
       
        
          
       
        Walterlv.ZeroUwp
           
       
        walterlv
           
       
        Assets\StoreLogo.png

不能忘掉，这份文件还需要添加到 csproj 项目文件中：

编写 AssemblyInfo.cs

由于没有新的基于 Sdk 的 csproj 文件支持，所以我们需要自己编写 AssemblyInfo.cs 文件，并放入到 Properties 文件夹中。

using System.Reflection;using System.Runtime.InteropServices;[assembly: AssemblyTitle("Walterlv.Demo.ZeroUwp")][assembly: AssemblyProduct("Walterlv.Demo.ZeroUwp")][assembly: AssemblyCopyright("Copyright © walterlv 2018")][assembly: AssemblyVersion("0.1.0.0")][assembly: AssemblyFileVersion("0.1.0.0")][assembly: ComVisible(false)]

最后，csproj 文件会如下面这样。


     
       
        
          
       
        Debug
           
       
        x86
           
       
        {7B81D14B-6094-44E1-9B2F-F577995A3CAF}
           
       
        AppContainerExe
           
       
        Properties
           
       
        Walterlv.Demo.ZeroUwp
           
       
        Walterlv.Demo.ZeroUwp
           
       
        en-US
           
       
        UAP
           
       
        10.0.17134.0
           
       
        10.0.17134.0
           
       
        14
           
       
        512
           
       
        {A5A43C5B-DE2A-4C0C-9213-0A381AF9435A};{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}
           
       
        true
         
        
          
       
        true
           
       
        bin\x86\Debug\
           
       
        DEBUG;TRACE;NETFX_CORE;WINDOWS_UWP
           
       
        ;2008
           
       
        full
           
       
        x86
           
       
        false
           
       
        prompt
           
       
        true
         
        
          
       
        bin\x86\Release\
           
       
        TRACE;NETFX_CORE;WINDOWS_UWP
           
       
        true
           
       
        ;2008
           
       
        pdbonly
           
       
        x86
           
       
        false
           
       
        prompt
           
       
        true
           
       
        true
         
        
          
       
        true
           
       
        bin\ARM\Debug\
           
       
        DEBUG;TRACE;NETFX_CORE;WINDOWS_UWP
           
       
        ;2008
           
       
        full
           
       
        ARM
           
       
        false
           
       
        prompt
           
       
        true
         
        
          
       
        bin\ARM\Release\
           
       
        TRACE;NETFX_CORE;WINDOWS_UWP
           
       
        true
           
       
        ;2008
           
       
        pdbonly
           
       
        ARM
           
       
        false
           
       
        prompt
           
       
        true
           
       
        true
         
        
          
       
        true
           
       
        bin\x64\Debug\
           
       
        DEBUG;TRACE;NETFX_CORE;WINDOWS_UWP
           
       
        ;2008
           
       
        full
           
       
        x64
           
       
        false
           
       
        prompt
           
       
        true
         
        
          
       
        bin\x64\Release\
           
       
        TRACE;NETFX_CORE;WINDOWS_UWP
           
       
        true
           
       
        ;2008
           
       
        pdbonly
           
       
        x64
           
       
        false
           
       
        prompt
           
       
        true
           
       
        true
         
        
          
       
        PackageReference
         
        
          
           
           
         
        
          
             
        
         Designer
            
           
           
           
           
         
        
          
             
        
         6.1.5
            
         
        
          
       
        14.0