探索 Python.Included：无缝集成Python到你的.NET应用中

2024-05-23 17:01:29作者：戚魁泉Nursing

Python.Included Logo

1、项目介绍

Python.Included 是一个创新的部署解决方案，专为依赖嵌入式 Python 分发的 .NET 包设计。这个项目旨在解决一个普遍问题：如何在没有本地 Python 安装的情况下，部署那些基于 Python 的库和包到 .NET 应用程序中。通过 Python.Included，你可以轻松地将 Python 集成到你的.NET环境中，无需考虑繁琐的安装过程。

2、项目技术分析

Python.Included 使用了一个内置的 Python（3.7.3 版本）副本，将其打包到 .NET 组件中。当你首次运行应用程序时，它会自动将 Python 安装到用户的主目录下。后续执行则会检测到已部署的 Python，避免了重复安装。此外，它还包含了用于安装 Python 轮子文件（.whl）的功能，以支持像 Numpy.NET 这样的库安装 Numpy。对于太大而无法直接打包进 .NET nuget 的包，Python.Included 支持使用 pip 进行安装。

重要的是，Python.Included 基于 pythonnet_netstandard，如果你不需要或不想要自动部署嵌入式 Python，可以直接使用该库。

3、项目及技术应用场景

简化 .NET 中的 Python 交互 - 对于希望在 .NET 应用中利用 Python 功能，但又不想让用户手动安装 Python 的开发者来说，Python.Included 是理想的选择。
嵌入式 Python 库管理 - Python 库如 Numpy 可以通过轮子文件方便地在嵌入式环境中进行安装，这样可以避免因库大小限制带来的困扰。
大型 Python 库安装 - 如果你的项目依赖于大体积的 Python 包，可以利用 pip 来下载并安装这些包，保持应用的轻量化。

4、项目特点

自动部署 - 自动在首次运行时部署 Python，后续运行无需再次安装。
模块化安装 - 内置 Python 轮子文件安装器，支持直接从资源文件安装库。
pip 支持 - 能够使用 pip 安装不适合直接嵌入的大体积库。
跨平台兼容性 - 目前稳定支持 Windows 平台，并寻求其他平台的支持。
广泛的应用 - 已被多个项目采用，包括 Numpy.NET 和 BHoM Python Toolkit。

要开始使用 Python.Included，请通过 NuGet 引用该项目，然后只需一行代码调用 await Installer.SetupPython(); 即可开始与 Python.NET 的交互。

using System;
using System.Threading.Tasks;
using Python.Included;
using Python.Runtime;

namespace NetCoreExample
{
    class Program
    {
        static async Task Main(string[] args)
        {
            await Installer.SetupPython();
            PythonEngine.Initialize();
            dynamic sys = PythonEngine.ImportModule("sys");
            Console.WriteLine("Python version: " + sys.version);
        }
    }
}