在 FreeBSD 上构建与运行 dotnet/runtime 的完整环境指南
在 FreeBSD 上构建与运行 dotnet/runtime 的完整环境指南【免费下载链接】runtime.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps.项目地址: https://gitcode.com/GitHub_Trending/runtime6/runtime本篇指南围绕 docs/workflow/requirements/freebsd-requirements.md 展开系统讲解在 FreeBSD 上构建与运行 .NET 运行时dotnet/runtime的三种可行路径使用预构建 Docker 镜像交叉编译、在 Linux 上交叉编译、以及直接在 FreeBSD 本机构建。读完本文你将掌握 FreeBSD 交叉编译所需的 Linux 宿主环境依赖、FreeBSD 本机工具链的安装命令、SDK 解压与 NuGet 本地包源配置的完整实操步骤并能结合仓库源码理解crossrootfs的构建原理。背景为什么 FreeBSD 构建不平凡dotnet/runtime 的官方构建产物与安装包主要面向主流操作系统没有面向 FreeBSD 的官方构建包仓库文档原文明确说明这一点因此在 FreeBSD 上进行原生构建并非开箱即用。从仓库文档的表述看社区一般有三种方案按易用程度排序使用预构建的 Docker 镜像进行交叉编译——最省事所有构建工具都已包含在镜像中在 Linux 环境中交叉编译——利用已有的 Linux 开发机借助crossrootfs构造 FreeBSD 目标环境直接在 FreeBSD 上构建——需要手动安装完整工具链文档标注为旧说明可能已过时。这三种方案在仓库中都有对应的工程支撑eng/common/cross/build-rootfs.sh负责构造 FreeBSD 的crossrootfseng/common/cross/toolchain.cmake负责识别 FreeBSD 目标并为 CMake 设置正确的系统名称而eng/RuntimeIdentifier.props与eng/native/configureplatform.cmake则在 MSBuild 与 CMake 两个层面声明 FreeBSD 的 target RID如freebsd-x64。方案一使用 Docker 镜像交叉编译Docker 方案的前提是先安装 Docker官方安装说明见 Docker 官网此处不赘述。仓库文档强调官方构建所用的 Docker 镜像已经内置了全部所需构建工具无需额外配置。拿到 Docker 环境后可以按照仓库的 Docker 构建文档 docs/workflow/using-docker.md 操作。这种方式之所以零配置是因为镜像内部已经预先完成了解析依赖、安装工具链、构造crossrootfs等一系列工作你只需挂载源码并触发构建脚本即可。方案二在 Linux 上交叉编译 FreeBSD先满足 Linux 常规构建前置条件要在 Linux 开发机上交叉编译 FreeBSD 目标首先需要满足常规的 Linux 构建前置条件详见 docs/workflow/requirements/linux-requirements.md。该文档提到Linux 构建至少需要 1GB 内存512MB 虚拟机已被证实构建会失败并且推荐使用eng/common/native/install-dependencies.sh辅助脚本安装依赖。构造 FreeBSD crossrootfs 所需的额外包交叉编译的机制是构造一个名为crossrootfs的目标系统根目录sysroot编译器借助它链接 FreeBSD 的库与头文件。要构造 FreeBSD 的crossrootfsLinux 宿主上需要额外安装 4 个包libbz2-dev——BZip2 压缩库开发头FreeBSDbase.txz使用 bzip2/xz 压缩解包需要liblzma-dev——LZMA 压缩库开发头base.txz是.txz即 xz 压缩的 tar 包libarchive-dev——libarchive 归档库开发头libbsd-dev——FreeBSD 兼容层库开发头此外如果做跨架构或跨系统的交叉编译如 Arm32、Arm64、Alpine、FreeBSDlinux-requirements.md 还要求安装binfmt-support、debootstrap、qemu、qemu-user-static这些包用于构造 rootfs而不是构建 runtime 本身。apt install binfmt-support debootstrap qemu qemu-user-staticcrossrootfs 构造的源码级原理eng/common/cross/build-rootfs.sh中与 FreeBSD 相关的逻辑非常直观。脚本的用法说明第 7-15 行明确列出CodeName - optional, Code name for Linux, can be: xenial(default), zesty, bionic, alpine for alpine can be specified with version: alpineX.YY or alpineedge for FreeBSD can be: freebsd14, freebsd15即调用时传入freebsd14或freebsd15即可触发 FreeBSD rootfs 构建。脚本内部eng/common/cross/build-rootfs.sh为 FreeBSD 预置了以下参数变量默认值说明__FreeBSDBase14.4-RELEASE下载的 FreeBSD 发行版本freebsd15 分支覆盖为15.1-RELEASE__FreeBSDPkg2.8.0需要从源码编译的 pkg 包管理器版本__FreeBSDABI14pkg ABI 标识freebsd15 覆盖为15__FreeBSDPackageslibunwind icu libinotify openssl krb5 terminfo-db装入 rootfs 的运行时依赖包构建流程第 612-640 行依次执行从download.freebsd.org下载对应架构/发行版本的base.txz解包出lib、usr/lib、usr/include、usr/share/keys、etc、bin/freebsd-version等目录到 rootfs写入pkg.conf指定 ABI、指纹目录、关闭仓库自动更新与FreeBSD.conf指向 quarterly 仓库从 GitHub 拉取 pkg 源码在 rootfs 内编译出 host 侧 pkg 工具用编译出的 pkg 以-r $__RootfsDir方式将上述 6 个依赖包装入 rootfs。而 eng/common/cross/toolchain.cmake 则在 CMake 层面把交叉环境正式声明为 FreeBSDset(CMAKE_SYSTEM_NAME FreeBSD) set(FREEBSD 1)后续所有 CMake 分支逻辑如链接器选择、系统库判断都会依据FREEBSD标志走 FreeBSD 路径。同样eng/native/configureplatform.cmake 与 eng/RuntimeIdentifier.props 分别在原生层与托管层标记CLR_CMAKE_HOST_FREEBSD/CLR_CMAKE_TARGET_FREEBSD与TargetsFreeBSD保证整体构建系统能正确识别freebsd-x64等目标 RID。方案三直接在 FreeBSD 上构建使用 pkg 安装工具链官方文档明确以下说明假设你使用 FreeBSD 默认的二进制包工具pkg等价于 Linux 的apt、apt-get或yum来安装环境。从 ports tree 编译依赖理论上可行但未经过测试。文档中FreeBSD 前置条件即将推出一节目前是占位状态FreeBSD Prerequisites Coming Soon!因此仓库暂时给出的是下面这套旧版说明。请注意这些说明撰写时间较早今天是否仍然有效无法保证新版本说明正在编写中。下面按文档原文完整给出便于读者评估使用。构建Toolchain Setup所需的包构建 dotnet/runtime 仓库需要先安装以下工具包作用Bash构建脚本build.sh等的解释器CMake原生代码构建系统icuICU 国际化库Unicode/全球化支持libunwind栈回溯库异常与诊断需要krb5Kerberos 认证库opensslSSL/TLS 支持可选python39构建辅助脚本运行时libinotifyinotify API 兼容层ninja快速构建工具配合 CMake安装命令需要 root 权限使用sudosudo pkg install --yes libunwind icu libinotify lttng-ust krb5 cmake openssl ninja从源码实现看这份依赖清单与 crossrootfs 中装入的包高度一致libunwind、icu、libinotify、openssl、krb5在 build-rootfs.sh 中都能找到说明无论是交叉编译还是本机构建运行时依赖都是同一组库。运行时运行Running on FreeBSD所需的包如果只是运行已构建好的 .NET需要安装的包略有不同包作用icu国际化库必需libunwind栈回溯库必需lttng-ustLTTng 用户态追踪可选调试支持krb5Kerberos 认证库opensslSSL 支持可选libinotifyinotify 兼容层terminfo-db终端信息数据库可选终端颜色安装命令sudo pkg install --yes libunwind icu libinotify lttng-ust krb5 openssl terminfo-db注意terminfo-db恰好也在交叉 rootfs 的预置依赖列表中见 eng/common/cross/build-rootfs.sh可见它确实是 .NET 在 FreeBSD 上运行时的常规依赖。解压 SDKSDK 的标准安装位置是/usr/share/dotnet。VERSION指正在解压的 SDK 版本号sudo mkdir /usr/share/dotnet tar xf /tmp/dotnet-sdk-VERSION-freebsd-x64.tar.gz -C /usr/share/dotnet/配置 NuGet 本地包源NuGet 包的标准缓存位置是/var/cache/nuget。VERSION与上面 SDK 的版本号相同需要准备以下三个.nupkgMicrosoft.NETCore.App.Host.freebsd-x64.VERSION.nupkgMicrosoft.NETCore.App.Runtime.freebsd-x64.VERSION.nupkgMicrosoft.AspNetCore.App.Runtime.freebsd-x64.VERSION.nupkg然后在使用的任意NuGet.config的packageSources节下添加一行本地源add keylocal value/var/cache/nuget /让 dotnet 命令可用最后把/usr/share/dotnet加入PATH或者为/usr/share/dotnet/dotnet创建符号链接二者选其一即可# 方式一加入 PATH export PATH/usr/share/dotnet:$PATH # 方式二创建符号链接 sudo ln -s /usr/share/dotnet/dotnet /usr/local/bin/dotnet小结与建议综合仓库文档与工程源码可以给出如下选型建议追求零配置优先使用官方 Docker 镜像交叉编译所有依赖已内置已有 Linux 开发机按 linux-requirements.md 装好常规依赖后再补装libbz2-dev、liblzma-dev、libarchive-dev、libbsd-dev通过eng/common/cross/build-rootfs.sh以freebsd14或freebsd15为 CodeName 构造crossrootfs即可触发交叉编译FreeBSD 本机构建参照文档给出的旧版说明安装工具链libunwind icu libinotify lttng-ust krb5 cmake openssl ninja但要注意这些说明可能已不适用于今天实际使用前建议对照当前分支的构建脚本核实依赖。由于 FreeBSD 没有官方构建包无论选择哪条路径crossrootfs或本机依赖中的运行时库集合都是固定的libunwind、icu、libinotify、openssl、krb5、terminfo-db——这正是 .NET 运行时在 FreeBSD 上稳定运行所需的底层支撑。【免费下载链接】runtime.NET is a cross-platform runtime for cloud, mobile, desktop, and IoT apps.项目地址: https://gitcode.com/GitHub_Trending/runtime6/runtime创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

TabPFN:小表格数据 3 步出结果的 Transformer 表格模型

TabPFN:小表格数据 3 步出结果的 Transformer 表格模型

TabPFN:小表格数据 3 步出结果的 Transformer 表格模型 【免费下载链接】TabPFN ⚡ TabPFN: Foundation Model for Tabular Data ⚡ 项目地址: https://gitcode.com/GitHub_Trending/ta/TabPFN TabPFN 是一个基于 Transformer 的表格数据基础模型&#xff0c…

2026/11/20 19:33:23 阅读更多 →
USB3.2 Gen1/Gen2/Gen2x2速度真相:速率、通道与编码三要素解析

USB3.2 Gen1/Gen2/Gen2x2速度真相:速率、通道与编码三要素解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/11/20 19:33:23 阅读更多 →
ONNX 发布管理:PyPI 存储清理操作指南(Release Administration)

ONNX 发布管理:PyPI 存储清理操作指南(Release Administration)

人工智能深度学习机器学习 【免费下载链接】onnx Open standard for machine learning interoperability 项目地址: https://gitcode.com/gh_mirrors/onn/onnx 点击查看 免费下载 导读 本文基于 ONNX 仓库的 docs/ReleaseAdministration.md 编写,系统讲…

2026/11/19 6:00:44 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/19 21:38:27 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/19 21:38:49 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/19 21:39:09 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/19 21:36:50 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/19 21:37:45 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/19 21:36:20 阅读更多 →

日新闻

周新闻

月新闻