---
title: "开发者参考"
description: "开发者参考记录随版本变化的细节：配置项、flag、默认值、限制、指标、边界情况和版本差异。概念请看 Primitives 和 Components。开发者参考只有英文版。"
canonical_url: "https://docs.superdurable.io/zh-Hans/reference/"
source: "docs/i18n/zh-Hans/docusaurus-plugin-content-docs/current/reference/index.mdx"
locale: "zh-Hans"
---

# 开发者参考

开发者参考记录随版本变化的细节：配置项、flag、默认值、限制、指标、边界情况和版本差异。概念请看 [Primitives](https://docs.superdurable.io/zh-Hans/primitives.md) 和 [Components](https://docs.superdurable.io/zh-Hans/primitives/components.md)。开发者参考只有英文版。

<a id="check-your-version-first"></a>

## 先确认版本

每个组件有自己的参考。查细节之前，先确认你运行的组件版本。用左侧栏顶部的版本选择器选择参考版本。每份参考默认打开最新版本。[兼容性矩阵](https://docs.superdurable.io/zh-Hans/reference.md#compatibility-matrix) 列出支持的组件组合。

Dex 按一个共享的 release train 发版。每次发版只给有改动的组件打 tag，所以组件的 minor 版本号可能跳过。对某个组件来说，release train 编号 N 指的是它不超过 N 的最新版本。

<a id="component-references"></a>

## 组件参考

| 组件                | 参考                                                                            | Release tag               |
| ----------------- | ----------------------------------------------------------------------------- | ------------------------- |
| Server（server-zd） | [Server 参考](https://docs.superdurable.io/zh-Hans/reference/server.md)         | **server-zd/v0.1.N**      |
| CLI（dexcli）       | [CLI 参考](https://docs.superdurable.io/zh-Hans/reference/cli.md)               | **cli-vX.Y.Z**            |
| Web（Dex Web）      | [Web 参考](https://docs.superdurable.io/zh-Hans/reference/web.md)               | **web/vX.Y.Z**            |
| Go SDK            | [Go 参考](https://docs.superdurable.io/zh-Hans/reference/go.md)                 | **sdk-go/vX.Y.Z**         |
| Python SDK        | [Python 参考](https://docs.superdurable.io/zh-Hans/reference/python.md)         | **sdk-python/vX.Y.Z**     |
| Java SDK          | [Java 参考](https://docs.superdurable.io/zh-Hans/reference/java.md)             | **sdk-java/vX.Y.Z**       |
| TypeScript SDK    | [TypeScript 参考](https://docs.superdurable.io/zh-Hans/reference/typescript.md) | **sdk-typescript/vX.Y.Z** |
| Rust SDK          | [Rust 参考](https://docs.superdurable.io/zh-Hans/reference/rust.md)             | **sdk-rust/vX.Y.Z**       |

<a id="compatibility-matrix"></a>

## 兼容性矩阵

Worker 和 Client 会和 server 协商协议版本。server-zd 0.1.17 及更新版本提供协议版本 4。

| 组件                                   | 版本   | 需要的 server-zd      |
| ------------------------------------ | ---- | ------------------ |
| Go、Python、Java、TypeScript 和 Rust SDK | 1.35 | 0.1.17 或更新（协议版本 4） |
| Dex Web                              | 1.35 | 0.1.17 或更新（协议版本 4） |

server-zd 协议版本 4 没有提高最低协议版本。1.35 之前的 SDK 在 server-zd 0.1.17 及更新版本上继续可用。先升级 server，再升级 SDK。见 [Upgrades and compatibility](https://docs.superdurable.io/zh-Hans/reference/server/upgrades.md)。

每个 **dexcli** 版本打包一个 server-zd 版本，**dexcli dev** 运行的就是它：

| dexcli | 打包的 server-zd |
| ------ | ------------- |
| 1.36   | 0.1.19        |
| 1.35   | 0.1.18        |
| 1.34   | 0.1.16        |
| 1.33   | 0.1.15        |
| 1.32   | 0.1.14        |

用 **dexcli dev** 运行 SDK 1.35 的应用时，使用 **dexcli** 1.35 或更新版本。

<a id="release-notes"></a>

## 发版说明

每个组件都在 GitHub 上发布发版说明。server-zd 的每个版本都列出 breaking change、新功能、修复和升级步骤。见 [Dex releases](https://github.com/superdurable/dex/releases)。