.NET Portability AnalyzerThe .NET Portability Analyzer

Sollen Ihre Bibliotheken auf mehreren Plattformen einsetzbar sein?Want to make your libraries multi-platform? Möchten Sie wissen, wie viel Arbeit erforderlich ist, um Ihre Anwendung mit anderen .NET-Implementierungen kompatibel zu machen?Want to see how much work is required to make your application compatible with other .NET implementations? .NET Portability Analyzer ist ein Tool, das Ihnen durch die Analyse von Assemblys einen detaillierten Bericht zur Flexibilität Ihres Programms auf verschiedenen .NET-Implementierungen bietet.The .NET Portability Analyzer is a tool that provides you with a detailed report on how flexible your program is across .NET implementations by analyzing assemblies. Portability Analyzer wird als Visual Studio-Extension und als Konsolen-App angeboten.The Portability Analyzer is offered as a Visual Studio Extension and as a console app.

Neue ZieleNew targets

  • .NET Core: Besitzt einen modularen Aufbau, verwendet die parallele Ausführung und ist auf plattformübergreifende Szenarios ausgerichtet..NET Core: Has a modular design, employs side-by-side, and targets cross-platform scenarios. Die parallele Ausführung ermöglicht Ihnen die Übernahme neuer Versionen von .NET Core, ohne andere Apps zu beeinträchtigen.Side-by-side allows you to adopt new .NET Core versions without breaking other apps.
  • ASP.NET Core: Ist ein modernes Webframework, das auf .NET Core beruht, sodass Entwickler von denselben Vorteilen profitieren.ASP.NET Core: is a modern web-framework built on .NET Core thus giving developers the same benefits.
  • Universelle Windows-Plattform: Verbessern Sie die Leistung Ihrer Windows Store-Apps, die mithilfe der statischen Kompilierung von .NET Native auf X64- und ARM-Computern ausgeführt werden.Universal Windows Platform: Improve performance of your Windows Store apps that run on x64 and ARM machines by using .NET Native’s static compilation.
  • .NET Core + Plattformerweiterungen: dazu zählen die .NET Core-APIs zusätzlich zu anderen APIs in der .NET-Umgebung wie z.B. WCF, ASP.NET Core, FSharp und Azure..NET Core + Platform Extensions: Includes the .NET Core APIs in addition to other APIs in the .NET ecosystem such as WCF, ASP.NET Core, FSharp, and Azure.
  • .NET Standard + Plattformerweiterungen: dazu zählen die .NET Standard-APIs zusätzlich zu anderen .NET-Umgebungen wie z.B. WCF, ASP.NET Core, FSharp und Azure..NET Standard + Platform Extensions: Includes the .NET Standard APIs in addition to other .NET ecosystem such as WCF, ASP.NET Core, FSharp, and Azure.

Gewusst wie: Verwenden von Portability AnalyzerHow to use Portability Analyzer

Um mit der Verwendung von .NET Portability Analyzer zu beginnen, müssen Sie die Erweiterung zunächst aus der Visual Studio Gallery herunterladen.To begin using the .NET Portability Analyzer, you first need to download and install the extension from the Visual Studio Gallery. Er wird in Visual Studio 2015 und Visual Studio 2017 unterstützt.It works on Visual Studio 2015 and Visual Studio 2017. Sie können ihn in Visual Studio über Analysieren > Einstellungen des Portability Analyzer konfigurieren und Ihre Zielplattformen auswählen.You can configure it in Visual Studio via Analyze > Portability Analyzer Settings and select your Target Platforms.

Screenshot zur Portabilität

Um das gesamte Projekt zu analysieren, klicken Sie mit der rechten Maustaste im Projektmappen-Explorer auf Ihr Projekt, und wählen Sie Assemblyportabilität analysieren aus.To analyze your entire project, right-click on your project in Solution Explorer and select Analyze Assembly Portability. Wechseln Sie andernfalls zum Menü Analysieren, und wählen Sie Assemblyportabilität analysieren.Otherwise, go to the Analyze menu and select Analyze Assembly Portability. Wählen Sie dort die ausführbare Datei oder DLL-Datei des Projekts aus.From there, select your project’s executable or DLL.

Projektmappen-Explorer für Portabilität

Nach dem Ausführen der Analyse wird Ihnen der .NET-Portabilitätsbericht angezeigt.After running the analysis, you will see your .NET Portability Report. Nur Typen, die von einer Zielplattform nicht unterstützt werden, sind in der Liste enthalten, und Sie können Empfehlungen auf der Registerkarte Meldungen in der Fehlerliste anzeigen.Only types that are unsupported by a target platform appear in the list and you can review recommendations in the Messages tab in the Error List. Zudem können Sie direkt von der Registerkarte Meldungen zu Problembereichen springen.You can also jump to problem areas directly from the Messages tab.

Portabilitätsbericht

Sie möchten Visual Studio nicht verwenden?Don’t want to use Visual Studio? Sie können Portability Analyzer auch von der Befehlszeile aus verwenden.You can also use the Portability Analyzer from the command prompt. Laden Sie einfach den API Portability Analyzer herunter.Just download the API Portability Analyzer.

  • Geben Sie den folgenden Befehl an, um das aktuelle Verzeichnis zu analysieren: \...\ApiPort.exe analyze -f .Type the following command to analyze the current directory: \...\ApiPort.exe analyze -f .
  • Um eine bestimmte Liste von DLL-Dateien zu analysieren, geben Sie den folgenden Befehl ein: \...\ApiPort.exe analyze -f first.dll -f second.dll -f third.dllTo analyze a specific list of .dll files, type the following command: \...\ApiPort.exe analyze -f first.dll -f second.dll -f third.dll

Der .NET-Portabilitätsbericht wird als Excel-Datei (.xlsx) im aktuellen Verzeichnis gespeichert.Your .NET Portability Report is saved as an Excel file (.xlsx) in your current directory. Die Registerkarte Details in der Excel-Arbeitsmappe enthält weitere Informationen.The Details tab in the Excel Workbook contains more information.

Weitere Informationen zum .NET Portability Analyzer, finden Sie auf der GitHub-Dokumentation und im Channel 9-Video Eine kurze Betrachtung des .NET Portability Analyzer.For more information on the .NET Portability Analyzer, visit the GitHub documentation and A Brief Look at the .NET Portability Analyzer Channel 9 video.