UWP: 实现 UWP 应用自启动

简介: 原文:UWP: 实现 UWP 应用自启动在上一篇文章中,我们实现了使用命令行来启动 UWP 应用,在这一篇文章中,我们会实现 UWP 应用自启用的实现,也即开机后或用户登陆后,应用自己启动。这些特性原来都是 Win32 程序所具备的,UWP 能够支持这些特性使得它和 Win32 程序的行为进一步相同。
原文: UWP: 实现 UWP 应用自启动

上一篇文章中,我们实现了使用命令行来启动 UWP 应用,在这一篇文章中,我们会实现 UWP 应用自启用的实现,也即开机后或用户登陆后,应用自己启动。这些特性原来都是 Win32 程序所具备的,UWP 能够支持这些特性使得它和 Win32 程序的行为进一步相同。 

实现

与实现命令行启动一样,实现自启动也大体上分为两步:首先,在 Package.appxmanifest 中添加 windows.startupTask 扩展(Extension);然后,在 App 类中处理 OnActivated 事件。事实上,除了这两步外,我们还需要增加检查 StartupTask 的状态并允许用户控制自启动的逻辑。

1. 修改 Package.appxmanifest 

右击项目中的 Package.appxmanifest 文件,在快捷菜单中选择“打开方式“->”XML 文本编辑器“。打开后,对它的内容按以下修改:

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
  xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap5="http://schemas.microsoft.com/appx/manifest/uap/windows10/5"
  IgnorableNamespaces="uap mp uap5">
  ...
  <Applications>
    <Application 
      ...
      <Extensions>
        <uap5:Extension Category="windows.startupTask" EntryPoint="AppAutoRun.App" Executable="AppAutoRun.exe">
          <uap5:StartupTask DisplayName="AppAutoRun" Enabled="true" TaskId="AppAutoRun"/>
        </uap5:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

上述加粗的部分就是添加的扩展 windows.startupTask,其 EntryPoint 和 Executable 属性分别指明 App 类的完整名称以及当前应用的 exe 名称。

在 Extension 节点中,添加了一个节点 StartupTask,它有三个属性,说明如下:

  • TaskId:任务Id,必填,在所有的 UWP 应用中,它必须是唯一的,不能和其它应用的 TaskId 相同;
  • Enabled:是否启用,必填,指明是否启用当前应用为自启动行为;
  • DisplayName:显示名称,可选,在“任务管理器”中“启动”选项卡中的显示名称;

需要说明的是,Enabled 属性应该设置为 false;事实上这个属性会被忽略;因为 UWP 要实现自启动,至少需要启动一次,并且向用户请求同意才行。另外目前只能添加一个 StartupTask 节点。

此时,可以将应用部署(Deploy)到本机上,然后,在“任务管理器”中“启动”选项卡上,我们就可以看到了。

这里,右击每个任务,可以对它的状态进行控制(启用/禁用),可以看到当前应用的状态是“已禁用”。注意,在设置它的状态之前,App 需要至少被启动过一次。否则这里的设置是不起作用的。

 2. 查看并更改任务状态

除了在 Package.appxmanifest 中增加扩展外,我们还需要使用相关的 API 来查看所添加的 StartupTask 的状态,以及对它的更改。在 MainPage.xaml 中增加以下代码:

    <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
        <Grid Margin="12">
            <StackPanel>
                <TextBlock x:Name="tbState" />
                <Button
                    x:Name="btnSetState"
                    Margin="0,4,0,0"
                    Click="btnSetState_Click" />
            </StackPanel>
        </Grid>
    </Grid>

在 MainPage.xaml.cs 中增加以下代码:

        private async void MainPage_Loaded(object sender, RoutedEventArgs e)
        {
            await LoadState();
        }

        public async Task LoadState()
        {
            var task = await StartupTask.GetAsync("AppAutoRun");
            this.tbState.Text = $"Status: {task.State}";
            switch (task.State)
            {
                case StartupTaskState.Disabled:
                    // 禁用状态
                    this.btnSetState.Content = "启用";
                    this.btnSetState.IsEnabled = true;
                    break;
                case StartupTaskState.DisabledByPolicy:
                    // 由管理员或组策略禁用
                    this.btnSetState.Content = "被系统策略禁用";
                    this.btnSetState.IsEnabled = false;
                    break;
                case StartupTaskState.DisabledByUser:
                    // 由用户手工禁用
                    this.btnSetState.Content = "被用户禁用";
                    this.btnSetState.IsEnabled = false;
                    break;
                case StartupTaskState.Enabled:
                    // 当前状态为已启用
                    this.btnSetState.Content = "已启用";
                    this.btnSetState.IsEnabled = false;
                    break;
            }
        }

        private async void btnSetState_Click(object sender, RoutedEventArgs e)
        {
            var task = await StartupTask.GetAsync("AppAutoRun");
            if (task.State == StartupTaskState.Disabled)
            {
                await task.RequestEnableAsync();
            }

            // 重新加载状态
            await LoadState();
        }

我们通过 StartupTask 类(位于 Windows.ApplicationModel 命名空间下)的 GetAsync 来获取指定 TaskId 的自启动任务(StartupTask)。StartupTask 类具有一个 State 的枚举属性,用于表示其状态。它们的值及其意义,在注释中已经说明。

补充说明以下几点:

  1. 最开始时,任务的 State 是 Disabled;
  2. 唯有当其 State 是 Disabled 时,才能以编程的方式使用启动;
  3. 当其 State 是 DisabledByUser 或 DisabledByPolicy,需要经由用户手工启动;
  4. 不支持以编程的方式使其 State 成为 Disabled;

通过 StartupTask 类的 RequestEnableAsync 方法,可以向用户请求将其启动,调用这个方法后,会弹出如下窗口:

当用户选择“启用”后,下次系统启动后它就会自动启动,反之,如果选择”禁用“,那么它的状态会是 DisabledByUser。要想启用它,就需要打开”任务管理器“,在”启动“选项卡上右击它,选择“启用”。

3. 处理 OnActivated 事件

然后,在 App 类的 OnActivated 事件上增加对 ActivationKind 类的判断,并作相应的处理即可。代码如下:

        protected override void OnActivated(IActivatedEventArgs args)
        {
            Frame rootFrame = Window.Current.Content as Frame;
            if (rootFrame == null)
            {
                rootFrame = new Frame();
                Window.Current.Content = rootFrame;
            }
            
            if (args.Kind == ActivationKind.StartupTask)
            {
                var startupArgs = args as StartupTaskActivatedEventArgs;
            }

            rootFrame.Navigate(typeof(MainPage), args.Kind);
            Window.Current.Activate();
        }

最后,要注意的是:如果启用了自启动,当系统启动后,应用会以最小化的方式启动。 

参考资料:

Configure your app to start at log-in

目录
相关文章
|
前端开发 UED
[UWP]不那么好用的ContentDialog
原文:[UWP]不那么好用的ContentDialog ContentDialog是UWP开发中最常用的组件之一,一个体验良好的UWP应用很难避免不去使用它。博客园里也有许多的文章介绍如何来利用ContentDialog实现各种自定义样式的弹窗界面。
1329 0
|
C# Windows 开发工具
WindowsXamlHost:在 WPF 中使用 UWP 的控件(Windows Community Toolkit)
原文 WindowsXamlHost:在 WPF 中使用 UWP 的控件(Windows Community Toolkit) Windows Community Toolkit 再次更新到 5.0。
1942 0
[UWP]了解IValueConverter
原文:[UWP]了解IValueConverter 1. 前言 IValueConverter是用于数据绑定的强大的武器,它用于Value在Binding Source和Binding Target之间的转换。
965 0
|
C# 程序员
[UWP]做个调皮的BusyIndicator
原文:[UWP]做个调皮的BusyIndicator 1. 前言 最近突然想要个BusyIndicator。做过WPF开发的程序员对BusyIndicator应该不陌生,Extended WPF Toolkit 提供了BusyIndicator的开源实现,Silverlight Toolkit也有一个,这次想要把这个控件移植到UWP中。
928 0
[UWP]使用Acrylic(亚克力)
原文:[UWP]使用Acrylic(亚克力) 1. 前言 在 如何使用Fluent Design System 这篇文章里已经简单介绍过Reveal的用法,这篇再详细介绍其它内容。 自Windows 8 放弃Aero后,群众对毛玻璃回归的呼声一致都很大。
1525 0
|
搜索推荐 API 开发者
简单说一下UWP中的JumpList
原文:简单说一下UWP中的JumpList   在Windows10的10856这个版本中,微软为桌面版提供了一组新的应用交互方式,磁贴和Toast通知的个性化都有了一定的改善。针对磁贴方面,微软为我们提供了一组新的API来扩充我们对应用的交互方式——JumpList。
823 0
|
C++ Windows C#
自动启动 Windows 10 UWP 应用
原文: https://docs.microsoft.com/zh-cn/windows/uwp/xbox-apps/automate-launching-uwp-apps 简介 开发人员有多种选项可用于实现自动启动通用 Windows 平台 (UWP) 应用。
1457 0
|
C# Windows
UWP使用AppService向另一个UWP客户端应用程序提供服务
原文:UWP使用AppService向另一个UWP客户端应用程序提供服务 在上篇里,我使用的是寄宿在WPF上的WCF进行两个程序间的通信,在解决问题的同时,我的同事也在思考能否使用UWP来做这件事。于是,我们发现了App Service,两个UWP应用沟通的桥梁。
1212 0
win10 uwp 重启软件
原文:win10 uwp 重启软件 在16299支持在软件自己重启,不需要让用户点击关闭然后启动,虽然我还不知道这个有什么用。
958 0
|
Windows 数据格式 XML
UWP: 通过命令行启动 UWP 应用
原文:UWP: 通过命令行启动 UWP 应用 最近在开发应用的过程中,我遇到了如标题所述的需求,其实主要是为了能够快捷启动应用,正像我们可以在“运行”对话框中可以输入一些可执行程序的名称后,就能够直接启动它;这样做,可以增加 App 的易用性。
2329 0