函数上手：从建仓库到跑通第一个函数

在 Foundry 中开始使用函数有三种语言选择：TypeScript v1、TypeScript v2 和 Python。关于每种语言支持的特性，请查阅语言特性支持规范。

尽管每种语言所支持的特性各不相同，但无论使用哪种语言，你都能访问相同的基础平台功能，包括运行、测试和发布函数。本页概述这些功能，帮助你理解如何使用函数仓库，而不论你将使用哪种语言。

关于特定语言的详细上手说明，请参考以下教程：

• TypeScript v1 函数上手
• TypeScript v2 函数上手
• Python 函数上手

阅读下面各节，了解关于函数仓库创建与使用的通用信息。

创建函数仓库时，你可以选择最适合你需求的语言。你可以从所选项目的 + New > Repository（+ 新建 > 仓库） 直接初始化函数仓库，也可以在 Code Repositories 应用中点击右上角的 + New repository（+ 新建仓库）。仓库初始化完成后，你就可以添加并运行函数。

关于如何为特定语言创建函数仓库的详细说明，请参考以下教程章节：

• 创建 TypeScript v1 函数仓库
• 创建 TypeScript v2 函数仓库
• 创建 Python 函数仓库

你可以在 Code Repositories 或 VS Code 工作区中开发函数仓库：

• VS Code 工作区（推荐）： 通过 Palantir 的 Visual Studio Code 扩展，使用实时预览、资源导入、SDK 生成、分支管理、集成终端以及函数发布管理。要在 VS Code 工作区中打开一个函数仓库，请在仓库头部选择 Edit in VS Code（在 VS Code 中编辑）。
• Code Repositories： 使用下面各节描述的、基于 Web 的开发环境来开发和管理函数。

了解如何在 VS Code 中导航函数开发。

函数实时预览让你能够在把函数提交到仓库之前先进行测试。在函数加入仓库后，你可以在实时预览中运行它。方法是：打开底部工具栏的 Functions（函数），选择 Live Preview（实时预览）。选择一个函数，输入参数值，然后点击 Run（运行） 执行函数。

选择右上角的 Commit（提交），将改动提交到仓库的 master 分支。

提交工作后，你会看到 Tag version（打标签版本） 选项。这会将仓库中的所有函数发布到 function registry，使它们能在平台各处被访问。

选择 Tag version，基于 master 分支打一个发布标签。根据改动的范围设置标签名称，然后选择 Tag and release（打标签并发布）。

要查看函数打标签与发布时的进度，请选择 View（查看） 弹窗，或导航到 Tags（标签） 标签页。一旦 Step 2: Release（第 2 步：发布） 完成，选择已发布的函数即可在 function registry 中查看它们。

当你所打标签的检查项通过后，导航回 Code Repositories 中的 Code（代码） 标签页，从底部工具栏选择 Functions（函数）。你应该能在 Published（已发布） 分区下看到你的新函数。选择它，试着运行这个新函数：

进一步了解如何在平台各处利用函数。