Skip to content

Commit 8599be1

Browse files
chenyu777mairaw
authored andcommitted
Update portability-analyzer.md (#1155)
* Update portability-analyzer.md Made some improvements to the topic * updates
1 parent 54da8ae commit 8599be1

File tree

1 file changed

+12
-11
lines changed

1 file changed

+12
-11
lines changed
Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,11 @@
11
---
2-
title: Tooling to help you on the process
3-
description: Tooling to help you on the process
2+
title: The .NET Portability Analyzer | .NET
3+
description: Learn how to use the .NET Portability Analyzer tool to evaluate how portable your code is among the various .NET Platforms.
44
keywords: .NET, .NET Core
55
author: blackdwarf
6+
ms.author: mairaw
67
manager: wpickett
7-
ms.date: 06/20/2016
8+
ms.date: 07/05/2016
89
ms.topic: article
910
ms.prod: .net-core
1011
ms.technology: .net-core-technologies
@@ -14,33 +15,33 @@ ms.assetid: 0375250f-5704-4993-a6d5-e21c499cea1e
1415

1516
# The .NET Portability Analyzer
1617

17-
Want to make your libraries multi-platform? Want to see how much work is required to make your application compatible with other .NET platforms? The [.NET Portability Analyzer](https://visualstudiogallery.msdn.microsoft.com/1177943e-cfb7-4822-a8a6-e56c7905292b) is a tool that provides you with a detailed report on how flexible your program is across .NET platforms by analyzing assemblies. The Portability Analyzer is offered as a Visual Studio Extension and as a console app.
18+
Want to make your libraries multi-platform? Want to see how much work is required to make your application compatible with other .NET platforms? The [.NET Portability Analyzer](http://go.microsoft.com/fwlink/?LinkID=507467) is a tool that provides you with a detailed report on how flexible your program is across .NET platforms by analyzing assemblies. The Portability Analyzer is offered as a Visual Studio Extension and as a console app.
1819

19-
## New Targets
20+
## New targets
2021

2122
* [.NET Core](https://www.dotnetfoundation.org/netcore): Has a modular design, employs side-by-side, and targets cross-platform scenarios. Side-by-side allows you to adopt new .NET Core versions without breaking other apps.
2223
* [ASP.NET Core](https://www.dotnetfoundation.org/aspnet-core): is a modern web-framework built on .NET Core thus giving developers the same benefits.
2324
* [.NET Native](https://blogs.msdn.microsoft.com/dotnet/2014/04/24/net-native-performance): Improve performance of your Windows Store apps that run on x64 and ARM machines by using .NET Native’s static compilation.
2425

25-
## How to Use Portability Analyzer
26+
## How to use Portability Analyzer
2627

27-
To begin using the .NET Portability Analyzer, download the extension from the Visual Studio Gallery. You can configure it in Visual Studio via **Tools > Options > .NET Portability Analyzer** and select your Target Platforms. For now, use ASP.NET Core as a proxy for all .NET Core-based platforms (for example, [Windows 10 .NET UAP apps](http://blogs.windows.com/buildingapps/2015/03/02/a-first-look-at-the-windows-10-universal-app-platform/)).
28+
To begin using the .NET Portability Analyzer, you first need to download and install the extension from the [Visual Studio Gallery](http://go.microsoft.com/fwlink/?LinkID=507467). You can configure it in Visual Studio via **Tools** > **Options** > **.NET Portability Analyzer** and select your Target Platforms. For now, use ASP.NET Core as a proxy for all .NET Core-based platforms (for example, [Windows 10 .NET UAP apps](http://blogs.windows.com/buildingapps/2015/03/02/a-first-look-at-the-windows-10-universal-app-platform/)).
2829

2930
![Portability screenshot](./media/portability-analyzer/portability-screenshot.png)
3031

31-
To analyze your entire project, right-click on your project in **Solution Explorer** and select **Analyze > Analyze Assembly Portability**. Otherwise, go to the **Analyze** menu and select **Analyze Assembly Portability**. From there, select your project’s executable or .dll.
32+
To analyze your entire project, right-click on your project in **Solution Explorer** and select **Analyze** > **Analyze Assembly Portability**. Otherwise, go to the **Analyze** menu and select **Analyze Assembly Portability**. From there, select your project’s executable or DLL.
3233

3334
![Portability Solution Explorer](./media/portability-analyzer/portability-solution-explorer.png)
3435

3536
After running the analysis, you will see your .NET Portability Report. Only types that are unsupported by a target platform will appear in the list and you can review recommendations in the **Messages** tab in the **Error List**. You can also jump to problem areas directly from the **Messages** tab.
3637

3738
![Portability Report](./media/portability-analyzer/portability-report.png)
3839

39-
Don’t want to use Visual Studio? You can also use the Portability Analyzer from the Command Prompt. Download the command-line analyzer [here](http://www.microsoft.com/download/details.aspx?id=42678).
40+
Don’t want to use Visual Studio? You can also use the Portability Analyzer from the command prompt. Just download the [API Portability Analyzer](http://www.microsoft.com/download/details.aspx?id=42678).
4041

4142
* Type the following command to analyze the current directory: `\...\ApiPort.exe .`
4243
* To analyze a specific list of .dll files, type the following command: `\...\ApiPort.exe first.dll second.dll third.dll`
4344

44-
Your .NET Portability Report will be saved as an Excel *.xlsx* file in your current directory. The **Details** tab in the Excel Workbook will contain more info.
45+
Your .NET Portability Report will be saved as an Excel file (*.xlsx*) in your current directory. The **Details** tab in the Excel Workbook will contain more information.
4546

46-
For more info on the .NET Portability Analyzer, read [this article](http://blogs.msdn.com/b/dotnet/archive/2014/08/06/leveraging-existing-code-across-net-platforms.aspx).
47+
For more info on the .NET Portability Analyzer, see the article [Leveraging existing code across .NET platforms](https://blogs.msdn.microsoft.com/dotnet/2014/08/06/leveraging-existing-code-across-net-platforms/) on the .NET blog.

0 commit comments

Comments
 (0)