Out of Browser配置,安装和卸载
最后更新于：2022-04-01 14:20:31
在上篇“[Silverlight实例教程 - Out of Browser开篇](http://www.cnblogs.com/jv9/archive/2010/07/08/1773276.html)”中，介绍了Silverlight的Out of Browser基础理论知识。本篇将介绍Silverlight的Out of Browser在实例开发前的基础设置以及一些开发技巧。
在创建Silverlight项目时，默认是不支持Out of Browser模式的，所以在使用Silverilght的Out of Browser前，需要对Silverlight项目进行设置，使其支持OOB项目安装和运行。在以下演示中，将创建一个演示例程，该例程将在后续教程中使用，由于该教程不属于Silverilght基础开发教程，所以这里，我不在细述如何创建Silverlight项目，
项目名称: SilverilghtOOBDemo
项目环境：VS2010 + Silverlight 4
Silverlight的Out of Browser应用设置
在Silverlight项目中，设置项目支持Out of Browser模式非常简单，首先右键选中SilverlightOOBDemo客户端项目，选择“Properties”属性
在项目属性栏，默认情况下已经选择了Silverlight标签，而在右边内容页面中，"Enable running application out of the browser"是没有被选中的，我们仅需要选中该选项，保存，即可设置当前Silverlight项目支持Out of Browser。
在"Enable running application out of the browser"选项下，可以看到一个Out-of-Browser Settings...按钮，点击进行该按钮，即可对Out-of-Browser进行设置：
从上图可以看出，开发人员可以通过这些属性，创建个性的Out of Browser应用。以上设置属性是保存在Visual Studio 2010中的OutOfBrowserSettings.xml文件中的，开发人员也可以通过修改该文件来设置OOB应用属性。
~~~
<OutOfBrowserSettings ShortName="SilverlightOOBDemo Application" EnableGPUAcceleration="False" ShowInstallMenuItem="True">
<OutOfBrowserSettings.Blurb>SilverlightOOBDemo Application on your desktop; at home, at work or on the go.</OutOfBrowserSettings.Blurb>
<OutOfBrowserSettings.WindowSettings>
<WindowSettings Title="SilverlightOOBDemo Application" />
</OutOfBrowserSettings.WindowSettings>
<OutOfBrowserSettings.Icons />
</OutOfBrowserSettings>
~~~
在完成以上设置后，点击确定和保存，该项目即可支持Out of Browser模式。
Silverlight的Out of Browser应用安装
Silverlight Out of Browser应用的安装很简单，作为开发人员我们可以通过两种方式提供给用户安装OOB应用到本地。
第一种方式是使用默认的右键菜单按钮安装应用到本地。
这种方式是Out of Browser默认的安装方式，但是该方式的弊端是不易与用户体验，每次用户要右键点击应用才能安装应用。作为专业Out of Browser应用，通常会使用第二种方式安装OOB应用到本地。
第二种方式，添加控件通过Application.Current.Install()事件安装应用到本地。
在当前应用的MainPage下，添加安装按钮，通过按钮点击事件安装应用到本地。
~~~
<Grid x:Name="LayoutRoot" Background="DimGray">
<Button x:Name="btInstall" Content="安装应用到本地" Width="200" Height="50" Click="btInstall_Click"/>
</Grid>
~~~
~~~
private void btInstall_Click(object sender, RoutedEventArgs e)
{
try
{
Application.Current.Install();
}
catch (InvalidOperationException ex)
{
MessageBox.Show("应用已经安装.");
}
catch (Exception ex)
{
MessageBox.Show("应用不能被安装，错误信息如下:" + Environment.NewLine + ex.Message);
}
}
~~~
通过上面简单代码也可以达到安装OOB应用到本地的效果。
对于较为专业的Out of Browser应用的安装，我们经常会添加一些代码对当前应用安装进行简单的判断，判断该应用是否已经被安装到了本地，如果已经安装，将忽略不再进行安装步骤。这是对OOB应用的一种保护措施。我们简单修改项目代码，
~~~
public MainPage()
{
InitializeComponent();
if (Application.Current.IsRunningOutOfBrowser)
{
btInstall.Visibility = Visibility.Collapsed;
lbStatus.Text = "我正在Out of Browser下运行";
}
else
{
btInstall.Visibility = Visibility.Visible;
lbStatus.Text = "我正在浏览器中运行";
}
if (Application.Current.InstallState != InstallState.Installed)
{
btInstall.IsEnabled = true;
}
else
{
btInstall.IsEnabled = false;
btInstall.Content = "应用已经安装到本地";
}
}
~~~
安装本地前：
安装本地后：
重复安装时：
对于安装时所处于的状态控制，我们可以通过InstallState进行判断。我们可以通过添加以下代码：
~~~
private void Current_InstallStateChanged(object sender, System.EventArgs e)
{
switch (Application.Current.InstallState)
{
case InstallState.Installing:
btInstall.IsEnabled = false;
btInstall.Content = "正在安装...";
break;
case InstallState.Installed:
btInstall.IsEnabled = false;
btInstall.Content = "已经安装";
MessageBox.Show("OOB应用已经安装到本地");
break;
case InstallState.NotInstalled:
btInstall.IsEnabled = true;
btInstall.Content = "点击安装该应用到本地"; break; case InstallState.InstallFailed:
MessageBox.Show("OOB应用安装失败"); btInstall.IsEnabled = false;
break;
}
}
~~~
当安装时，用户可以看到提示：
以上是Silverlight Out of Browser安装方法和一些控制技巧。
Silverlight的Out of Browser应用卸载
Silverlight的OOB应用卸载同样很简单，Silverlight没有和安装时候的Install API，所以我们无法通过代码的方式控制卸载，但是可以通过以下两种方式卸载应用：
1. 右键点击应用，选择卸载应用选项；
2. 通过Windows“控制面板"，选择对应应用进行卸载，这个是传统型卸载方法，这里不再赘述.
简单实例
在这个简单实例中，我将在当前的OOB应用中添加一个简单的网络监测代码，演示该应用在线和离线时的网络状态。在该应用，我们仍旧会使用System.Windows.Application API来判断应用是否离线安装，而我们还会使用System.Net.NetworkInformation API来判断其网络状态。简单修改代码如下：
~~~
<UserControl x:Class="SilverlightOOBDemo.MainPage"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d"
d:DesignHeight="300" d:DesignWidth="400">
<Grid x:Name="LayoutRoot" Background="DimGray">
<StackPanel Orientation="Vertical">
<Button x:Name="btInstall" Content="安装应用到本地" Width="200" Height="50" Click="btInstall_Click"/>
<TextBlock x:Name="lbStatus" Foreground="White" HorizontalAlignment="Center" FontSize="18"/>
<TextBlock x:Name="lbNetworkStatus" Foreground="LightGreen" HorizontalAlignment="Center" FontSize="18"/>
</StackPanel>
</Grid>
</UserControl>
~~~
~~~
private void CheckNetworkStatus()
{
if (NetworkInterface.GetIsNetworkAvailable())
{
lbNetworkStatus.Foreground = new SolidColorBrush(Color.FromArgb(255,90,240,90));
lbNetworkStatus.Text = "当前网络处于连接状态";
}
else
{
lbNetworkStatus.Foreground = new SolidColorBrush(Colors.Red);
lbNetworkStatus.Text = "当前网络处于断线状态";
}
}
private void NetworkChange_NetworkAddressChanged(object sender, EventArgs e)
{
CheckNetworkStatus();
}
~~~
修改构造函数代码：
~~~
public MainPage()
{
InitializeComponent();
if (Application.Current.IsRunningOutOfBrowser)
{
btInstall.Visibility = Visibility.Collapsed;
lbStatus.Text = "我正在Out of Browser下运行";
}
else
{
btInstall.Visibility = Visibility.Visible;
lbStatus.Text = "我正在浏览器中运行";
}
if (Application.Current.InstallState != InstallState.Installed)
{
btInstall.IsEnabled = true;
}
else
{
btInstall.IsEnabled = false;
btInstall.Content = "应用已经安装到本地";
}
CheckNetworkStatus();
Application.Current.InstallStateChanged += Current_InstallStateChanged;
NetworkChange.NetworkAddressChanged += new NetworkAddressChangedEventHandler(NetworkChange_NetworkAddressChanged);
}
~~~
运行后可以在离线状态下，查看网络应用状态：
本文主要讲述Silverlight的Out of Browser应用设置，安装和卸载，属于Silverlight实例开发前的基础，下一篇我将继续介绍Silverlight的Out of Browser应用开发基础。
[本篇代码下载](http://files.cnblogs.com/jv9/SilverlightOOBDemo.zip)
欢迎大家加入"专注Silverlight" 技术讨论群：
32679955(六群)
23413513(五群)
32679922(四群)
100844510(三群)
37891947(二群)
22308706(一群)