与众不同 windows phone (38) - 8.0 关联启动: 使用外部程序打开一个文件或URI, 关联指定的文件类型或协议

原文:与众不同 windows phone (38) - 8.0 关联启动: 使用外部程序打开一个文件或URI, 关联指定的文件类型或协议

[源码下载]

与众不同 windows phone (38) - 8.0 关联启动: 使用外部程序打开一个文件或URI, 关联指定的文件类型或协议

作者：webabcd

介绍
与众不同 windows phone 8.0 之 关联启动

• 使用外部程序打开一个文件
• 使用外部程序打开一个 Uri
• 关联指定的文件类型
• 关联指定的协议

示例
1、演示如何使用外部程序打开一个文件
AssociationLaunching/LaunchFile.xaml

<phone:PhoneApplicationPage
    x:Class="Demo.AssociationLaunching.LaunchFile"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:phone="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone"
    xmlns:shell="clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    FontFamily="{StaticResource PhoneFontFamilyNormal}"
    FontSize="{StaticResource PhoneFontSizeNormal}"
    Foreground="{StaticResource PhoneForegroundBrush}"
    SupportedOrientations="Portrait" Orientation="Portrait"
    mc:Ignorable="d"
    shell:SystemTray.IsVisible="True">

    <Grid Background="Transparent">
        <StackPanel>

            <TextBlock Name="lblMsg" Margin="0 0 0 10" />

            <Button Content="打开一个 .log 文件" Name="btnLaunchFile" Click="btnLaunchFile_Click" />

        </StackPanel>
    </Grid>

</phone:PhoneApplicationPage>

AssociationLaunching/LaunchFile.xaml.cs

/*
 * 演示如何使用外部程序打开一个文件
 */

using System;
using System.Windows;
using Microsoft.Phone.Controls;
using Windows.Storage;
using System.IO;
using System.Text;

namespace Demo.AssociationLaunching
{
    public partial class LaunchFile : PhoneApplicationPage
    {
        public LaunchFile()
        {
            InitializeComponent();
        }

        private async void btnLaunchFile_Click(object sender, RoutedEventArgs e)
        {
            // 在 ApplicationData 的根目录下写一个 myLog.log 文件
            StorageFolder applicationFolder = ApplicationData.Current.LocalFolder;
            StorageFile storageFile = await applicationFolder.CreateFileAsync("myLog.log", CreationCollisionOption.ReplaceExisting);
            using (Stream stream = await storageFile.OpenStreamForWriteAsync())
            {
                byte[] content = Encoding.UTF8.GetBytes("hello webabcd");
                await stream.WriteAsync(content, 0, content.Length);
            }

            // 启动与 .log 类型文件关联的默认应用程序，来打开指定的文件
            Windows.System.Launcher.LaunchFileAsync(storageFile);
        }
    }
}

2、演示如何使用外部程序打开一个 Uri（自定义协议）
AssociationLaunching/LaunchUri.xaml

<phone:PhoneApplicationPage
    x:Class="Demo.AssociationLaunching.LaunchUri"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:phone="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone"
    xmlns:shell="clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    FontFamily="{StaticResource PhoneFontFamilyNormal}"
    FontSize="{StaticResource PhoneFontSizeNormal}"
    Foreground="{StaticResource PhoneForegroundBrush}"
    SupportedOrientations="Portrait" Orientation="Portrait"
    mc:Ignorable="d"
    shell:SystemTray.IsVisible="True">

    <Grid Background="Transparent">
        <StackPanel>

            <TextBlock Name="lblMsg" Margin="0 0 0 10" />

            <Button Content="启动一个协议名为 webabcd 的 uri" Name="btnLaunchUri" Click="btnLaunchUri_Click" />

        </StackPanel>
    </Grid>

</phone:PhoneApplicationPage>

AssociationLaunching/LaunchUri.xaml.cs

/*
 * 演示如何使用外部程序打开一个 Uri（自定义协议）
 */

using System.Windows;
using Microsoft.Phone.Controls;
using Windows.Networking.Proximity;

namespace Demo.AssociationLaunching
{
    public partial class LaunchUri : PhoneApplicationPage
    {
        public LaunchUri()
        {
            InitializeComponent();
        }

        private void btnLaunchUri_Click(object sender, RoutedEventArgs e)
        {
            // 使用外部程序打开指定的 Uri（自定义协议，注意这里没有“//”）
            Windows.System.Launcher.LaunchUriAsync(new System.Uri("webabcd:hello webabcd"));

            // nfc 方式启用另一台 wp nfc 设备打开指定的 Uri（需要在 manifest 中声明 ID_CAP_NETWORKING 和 ID_CAP_PROXIMITY）
            ProximityDevice nfcDevice = ProximityDevice.GetDefault();
            if (nfcDevice != null)
            {
                long Id = nfcDevice.PublishUriMessage(new System.Uri("webabcd:hello webabcd"));
            }
        }
    }
}

3、演示如何关联指定的文件类型（即用本程序打开指定类型的文件）
AssociationLaunching/FileTypeAssociation.xaml

<phone:PhoneApplicationPage
    x:Class="Demo.AssociationLaunching.FileTypeAssociation"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:phone="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone"
    xmlns:shell="clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    FontFamily="{StaticResource PhoneFontFamilyNormal}"
    FontSize="{StaticResource PhoneFontSizeNormal}"
    Foreground="{StaticResource PhoneForegroundBrush}"
    SupportedOrientations="Portrait" Orientation="Portrait"
    mc:Ignorable="d"
    shell:SystemTray.IsVisible="True">

    <Grid Background="Transparent">
        <StackPanel>

            <TextBlock Name="lblMsg" TextWrapping="Wrap" />

            <TextBlock TextWrapping="Wrap" Margin="0 10 0 0">
                <Run>本程序可以打开 .log 类型的文件</Run>
                <LineBreak />
                <Run>测试方法：通过 LaunchFile.xaml 打开一个 .log 类型的文件</Run>
            </TextBlock>

        </StackPanel>
    </Grid>

</phone:PhoneApplicationPage>

AssociationLaunching/FileTypeAssociation.xaml.cs

/*
 * 演示如何关联指定的文件类型（即用本程序打开指定类型的文件）
 *
 *
 * 由于配置为 NavUriFragment="fileToken=%s"，所以本 app 打开某类型的文件会通过 /FileTypeAssociation?fileToken=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 启动
 * 相关的 UriMapper 参见 MyUriMapper.cs
 *
 *
 * 注：
 * 需要在 manifest 中增加类似如下的配置
 *  <Extensions>
      <!--
          NavUriFragment="fileToken=%s" 的意思是：
          1、某 app 启动外部程序打开 .xxx 文件时会传递文件的 token
          2、如果最终是由本 app 打开 .xxx 文件，则本 app 会通过 /FileTypeAssociation?fileToken=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 启动
      -->
      <FileTypeAssociation TaskID="_default" Name="myFileTypeAssociation" NavUriFragment="fileToken=%s">
        <Logos>
          <!--相关类型的文件显示在电子邮件附件中的图标，33x33 像素，其会显示在白色的背景前-->
          <Logo Size="small" IsRelative="true">Assets/AppIcon_33x33.png</Logo>
          <!--相关类型的文件显示在 Office 中心列表视图中的图标，69x69 像素，其会显示在白色的背景前-->
          <Logo Size="medium" IsRelative="true">Assets/AppIcon_69x69.png</Logo>
          <!--相关类型的文件显示在浏览器下载中的图标，176x176 像素，其会显示在白色的背景前-->
          <Logo Size="large" IsRelative="true">Assets/AppIcon_176x176.png</Logo>
        </Logos>
        <SupportedFileTypes>
          <!--关联的文件类型列表-->
          <FileType ContentType="text/plain">.log</FileType>
          <FileType ContentType="application/rar">.rar</FileType>
        </SupportedFileTypes>
      </FileTypeAssociation>
    </Extensions>
 */

using System;
using System.Collections.Generic;
using System.Windows.Navigation;
using Microsoft.Phone.Controls;
using Windows.Phone.Storage.SharedAccess;
using Windows.Storage;
using Windows.Storage.Streams;
using System.IO;
using System.Text;

namespace Demo.AssociationLaunching
{
    public partial class FileTypeAssociation : PhoneApplicationPage
    {
        public FileTypeAssociation()
        {
            InitializeComponent();
        }

        protected async override void OnNavigatedTo(NavigationEventArgs e)
        {
            IDictionary<string, string> queryStrings = this.NavigationContext.QueryString;

            if (queryStrings.ContainsKey("fileToken"))
            {
                // 获取需要打开的文件的 token
                string fileToken = queryStrings["fileToken"];
                // 保存需要打开的文件到本 app 的 ApplicationData
                await SharedStorageAccessManager.CopySharedFileAsync(ApplicationData.Current.LocalFolder, "myLog2.log", NameCollisionOption.ReplaceExisting, fileToken);
                // 获取文件的文件名称
                string fileName = SharedStorageAccessManager.GetSharedFileName(fileToken);

                lblMsg.Text = "fileName: " + fileName;
                lblMsg.Text += Environment.NewLine;

                // 获取 ApplicationData 中指定的文件
                StorageFolder applicationFolder = ApplicationData.Current.LocalFolder;
                StorageFile storageFile = await applicationFolder.GetFileAsync("myLog2.log");

                // 显示文件内容
                IRandomAccessStreamWithContentType accessStream = await storageFile.OpenReadAsync();
                using (Stream stream = accessStream.AsStreamForRead((int)accessStream.Size))
                {
                    byte[] content = new byte[stream.Length];
                    await stream.ReadAsync(content, 0, (int)stream.Length);

                    lblMsg.Text += Encoding.UTF8.GetString(content, 0, content.Length);
                }
            }

            base.OnNavigatedTo(e);
        }
    }
}

4、演示如何关联指定的协议（即用本程序处理指定的协议）
AssociationLaunching/ProtocolAssociation.xaml

<phone:PhoneApplicationPage
    x:Class="Demo.AssociationLaunching.ProtocolAssociation"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:phone="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone"
    xmlns:shell="clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    FontFamily="{StaticResource PhoneFontFamilyNormal}"
    FontSize="{StaticResource PhoneFontSizeNormal}"
    Foreground="{StaticResource PhoneForegroundBrush}"
    SupportedOrientations="Portrait" Orientation="Portrait"
    mc:Ignorable="d"
    shell:SystemTray.IsVisible="True">

    <Grid Background="Transparent">
        <StackPanel>

            <TextBlock Name="lblMsg" TextWrapping="Wrap" />

            <TextBlock TextWrapping="Wrap" Margin="0 10 0 0">
                <Run>本程序可以处理 webabcd 协议</Run>
                <LineBreak />
                <Run>测试方法：通过 LaunchUri 打开一个名为 webabcd 的协议</Run>
            </TextBlock>

        </StackPanel>
    </Grid>

</phone:PhoneApplicationPage>

AssociationLaunching/ProtocolAssociation.xaml.cs

/*
 * 演示如何关联指定的协议（即用本程序处理指定的协议）
 *
 *
 * 由于配置为 NavUriFragment="encodedLaunchUri=%s"，所以本 app 打开某协议会通过 /Protocol?encodedLaunchUri=webabcd:xxxxxxxxxx 启动
 * 相关的 UriMapper 参见 MyUriMapper.cs
 *
 *
 * 注：
 * 需要在 manifest 中增加类似如下的配置
 *  <Extensions>
      <!--
          Name 是协议名称，对于本例来说协议的示例为“webabcd:hello webabcd”，注意其没有“//”
      -->
      <Protocol TaskID="_default" Name="webabcd" NavUriFragment="encodedLaunchUri=%s" />
    </Extensions>
 */

using System.Collections.Generic;
using System.Windows.Navigation;
using Microsoft.Phone.Controls;

namespace Demo.AssociationLaunching
{
    public partial class ProtocolAssociation : PhoneApplicationPage
    {
        public ProtocolAssociation()
        {
            InitializeComponent();
        }

        protected override void OnNavigatedTo(NavigationEventArgs e)
        {
            // 显示协议的详细信息
            IDictionary<string, string> queryStrings = this.NavigationContext.QueryString;
            if (queryStrings.ContainsKey("protocol"))
            {
                lblMsg.Text = queryStrings["protocol"];
            }

            base.OnNavigatedTo(e);
        }
    }
}

自定义 UriMapper，用于处理当本 app 由文件打开或协议打开或镜头扩展打开或图片扩展打开时，导航到相关的处理页面
MyUriMapper.cs

/*
 * 自定义 UriMapper，用于处理当本 app 由文件打开或协议打开或镜头扩展打开或图片扩展打开时，导航到相关的处理页面
 *
 * 注：
 * 要使此 UriMapper 有效，需要在 App.xaml.cs 中增加 RootFrame.UriMapper = new Demo.MyUriMapper();
 */

using System;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Windows.Navigation;
using Windows.Phone.Storage.SharedAccess;

namespace Demo
{
    public class MyUriMapper : UriMapperBase
    {
        public override Uri MapUri(Uri uri)
        {
            string tempUrl = HttpUtility.UrlDecode(uri.ToString());

            // 由文件启动本 app 时会通过 /FileTypeAssociation?fileToken=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 启动
            if (tempUrl.StartsWith("/FileTypeAssociation"))
            {
                // 获取 fileToken
                int fileTokenIndex = tempUrl.IndexOf("fileToken=") + 10;
                string fileToken = tempUrl.Substring(fileTokenIndex);

                // 获取相关的文件名
                string fileName = SharedStorageAccessManager.GetSharedFileName(fileToken); // myLog.log

                // 获取相关的文件名的扩展名
                string fileType = Path.GetExtension(fileName);

                // 根据文件类型的不同导航到不同的处理页面
                switch (fileType)
                {
                    case ".log":
                        return new Uri("/AssociationLaunching/FileTypeAssociation.xaml?fileToken=" + fileToken, UriKind.Relative);
                    default:
                        return new Uri("/MainPage.xaml", UriKind.Relative);
                }
            }
            // 由协议启动本 app 时会通过 /Protocol?encodedLaunchUri=webabcd:xxxxxxxxxx 启动
            else if (tempUrl.StartsWith("/Protocol"))
            {
                // 获取协议的详细信息
                int protocolIndex = tempUrl.IndexOf("encodedLaunchUri=") + 17;
                string protocol = tempUrl.Substring(protocolIndex);

                // 导航到处理 webabcd 协议的处理页面
                return new Uri("/AssociationLaunching/ProtocolAssociation.xaml?protocol=" + protocol, UriKind.Relative);
            }
            // 由镜头扩展启动本 app 时会通过 /MainPage.xaml?Action=ViewfinderLaunch 启动
            else if (tempUrl.Contains("Action=ViewfinderLaunch"))
            {
                return new Uri("/CameraAndPhoto/LensExtensibility.xaml?fromLens=true", UriKind.Relative);
            }
            // 由图片扩展之“共享...”启动本 app 时会通过 /MainPage.xaml?Action=ShareContent&FileId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} 启动
            else if (tempUrl.Contains("Action=ShareContent"))
            {
                string fileId = tempUrl.Substring(tempUrl.IndexOf("FileId=") + 7).Replace("{", "").Replace("}", "");
                return new Uri("/CameraAndPhoto/PhotoExtensibility.xaml?type=share&token=" + fileId, UriKind.Relative);
            }
            // 由图片扩展之“编辑...”启动本 app 时会通过 /MainPage.xaml?Action=EditPhotoContent&FileId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} 启动
            else if (tempUrl.Contains("Action=EditPhotoContent"))
            {
                string fileId = tempUrl.Substring(tempUrl.IndexOf("FileId=") + 7).Replace("{", "").Replace("}", "");
                return new Uri("/CameraAndPhoto/PhotoExtensibility.xaml?type=edit&token=" + fileId, UriKind.Relative);
            }
            // 由图片扩展之“自动上传”启动本 app 时会通过 /MainPage.xaml?Action=ConfigurePhotosUploadSettings 启动
            else if (tempUrl.Contains("Action=ConfigurePhotosUploadSettings"))
            {
                return new Uri("/CameraAndPhoto/PhotoAutoUpload.xaml?fromConfig=true", UriKind.Relative);
            }
            // 在锁屏设置界面，如果将本 app 设置为背景提供程序，则锁屏界面上会有一个名为“打开应用”的按钮，点击后会通过 /MainPage.xaml?WallpaperSettings=1 启动本 app
            else if (tempUrl.Contains("WallpaperSettings=1"))
            {
                return new Uri("/Others/LockScreen.xaml?WallpaperSettings=1", UriKind.Relative);
            }

            return uri;
        }
    }
}

将此 app 的 UriMapper 设置为我们自定义的 UriMapper
App.xaml.cs

private void InitializePhoneApplication()
{
    // 设置本 app 的 UriMapper
    RootFrame.UriMapper = new Demo.MyUriMapper();
}

OK
[源码下载]