Fable.Package.SDK 1.0.0

Fable.Package.SDK

Fable.Package.SDK 是一组 MSBuild 目标和任务，可帮助您构建和包装 Fable 项目。

特性 🚀

• 根据 FablePackageType 属性自动将 Fable 特定标记添加到 PackageTags
• 如果需要，自动在包中包含 F# 源文件
• 检查是否在 PackageTags 属性中定义了至少一个 Fable 目标
• 将 GenerateDocumentationFile 设置为 true
• 通过设置以下内容来为 IDE 体验优化您的包
  • DebugType 为 embedded
  • EmbedUntrackedSources 为 true

安装

dotnet add package Fable.Package.SDK

使用方法

1. 设置 FablePackageType 属性

在您的项目文件中将 FablePackageType 属性设置为以下值之一

• library: 如果您的包是一个库，可被 Fable 所用。

  库的示例包括 Fable.Promise、Elmish、Thoth.Json、Feliz

  这将在包中包含源文件。

• binding: 如果您的包由一组 API 组成，这些 API 可用于使本地库可用

  例如

  • 一个使 NPM 包 API 可用的包
  • 一个使浏览器 API 可用的包
  • 一个使 cargo 包 API 可用的包

  <br/>

  包中仅包含 DLL，允许更快地构建并减小包的大小。

2. 指定目标

选择以下标签之一或多个

• fable-dart: 包支持 Dart
• fable-dotnet: 包支持 .NET
• fable-javascript: 包支持 JavaScript
• fable-python: 此包支持 Python
• fable-rust: 此包支持 Rust
• fable-all: 包与所有 Fable 目标兼容。

[!警告] 如果一个包仅依赖也与所有目标兼容的包，则它可以与所有目标兼容。

与所有目标兼容的包不能是绑定，因为这些是特定于目标的。

示例

如果你的包只支持 JavaScript，你需要使用 fable-javascript

如果你的包同时支持 JavaScript 和 Python，你需使用 fable-javascript 和 fable-python

用例示例

如果你的包是一个针对 JavaScript 的绑定，你需要编写：

<PropertyGroup>
    <PackageTags>fable-javascript</PackageTags>
    <FablePackageType>binding</FablePackageType>
</PropertyGroup>

如果你的包是一个同时针对 JavaScript 和 Python 的库，你需要编写：

<PropertyGroup>
    <PackageTags>fable-javascript;fable-python</PackageTags>
    <FablePackageType>library</FablePackageType>
</PropertyGroup>