Skip to content

Commit cc2cd69

Browse files
DMwangnimaDMwangnima
committed
docs: kitex v0.14.0 release blog
1 parent 9c7fb3a commit cc2cd69

4 files changed

Lines changed: 180 additions & 0 deletions

File tree

‎content/en/blog/releases/Kitex/release-v0_14_0.md‎

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
1+
---
2+
title: "Kitex Release v0.14.0"
3+
linkTitle: "Release v0.14.0"
4+
projects: ["Kitex"]
5+
date: 2025-06-26
6+
description: >
7+
---
8+
9+
## **Introduction to Key Changes**
10+
11+
### **New Features**
12+
1. **Generic Call: The generic Client supports streaming calls, allowing a single Client to handle both streaming and non-streaming scenarios**
13+
14+
It supports streaming generic calls, adapting to gRPC/TTHeader Streaming and supporting map/JSON and Protobuf binary generic calls.
15+
16+
### **Feature/Experience Optimization**
17+
1. **Streaming: Improved observability and debugging experience**
18+
19+
**TTHeader Streaming**
20+
- If Tracer configured, failure to create a stream will now be reported with metrics.
21+
- When a panic occurs on the Server side, the full stack trace will now be printed for easier troubleshooting.
22+
23+
**gRPC Streaming**
24+
- If Tracer configured, failure to create a stream will now be reported with metrics.
25+
26+
### **Others**
27+
1. **Code Product Simplification**
28+
29+
Kitex tool no longer generates fastpb, only affecting Protobuf users.
30+
31+
If high-performance Protobuf encoding/decoding is required, you can enable prutal by configuring environment variable `KITEX_TOOL_USE_PRUTAL_MARSHAL=1`.
32+
33+
## **Full Change**
34+
### Feature
35+
[[#1759](https://github.com/cloudwego/kitex/pull/1759)] feat(tool): add env for using prutal to marshal
36+
37+
[[#1782](https://github.com/cloudwego/kitex/pull/1782)] feat(ttstream): process MetaFrame and reflect to rpcinfo
38+
39+
[[#1777](https://github.com/cloudwego/kitex/pull/1777)] feat(client): report err when create Stream failed
40+
41+
[[#1763](https://github.com/cloudwego/kitex/pull/1763)] feat: support ttheader streaming generic call
42+
43+
[[#1771](https://github.com/cloudwego/kitex/pull/1771)] feat(tool): add thriftgo patcher extension
44+
45+
[[#1755](https://github.com/cloudwego/kitex/pull/1755)] feat: add generic binary pb for streamx
46+
47+
[[#1752](https://github.com/cloudwego/kitex/pull/1752)] feat(generic): support generic pb binary for streaming
48+
49+
### Optimize
50+
[[#1788](https://github.com/cloudwego/kitex/pull/1788)] optimize: go net implementation
51+
52+
[[#1786](https://github.com/cloudwego/kitex/pull/1786)] optimize(tool): remove tool fastpb generation
53+
54+
[[#1783](https://github.com/cloudwego/kitex/pull/1783)] optimize(gRPC): parse PayloadCodec in server side
55+
56+
[[#1780](https://github.com/cloudwego/kitex/pull/1780)] optimize(ttstream): log the error thrown by invoking handler
57+
58+
[[#1769](https://github.com/cloudwego/kitex/pull/1769)] optimize: injection of options in ttstream
59+
60+
### Fix
61+
[[#1792](https://github.com/cloudwego/kitex/pull/1792)] fix(gRPC): inject current method name to rpcinfo in server-side to fix FROM_METHOD missing
62+
63+
[[#1787](https://github.com/cloudwego/kitex/pull/1787)] fix(ttstream): metrics missing caused by server-side rpcinfo not set correctly
64+
65+
[[#1778](https://github.com/cloudwego/kitex/pull/1778)] fix: enabling json mode of map generic not work
66+
67+
[[#1774](https://github.com/cloudwego/kitex/pull/1774)] fix(server): trans server conn count race issue
68+
69+
[[#1742](https://github.com/cloudwego/kitex/pull/1742)] fix(generic): align dynamicgo's write base behavior with old generic (only for internal logic)
70+
71+
### Refactor
72+
[[#1770](https://github.com/cloudwego/kitex/pull/1770)] refactor: refactor generic streaming
73+
74+
### Test
75+
[[#1793](https://github.com/cloudwego/kitex/pull/1793)] test: add go1.18 to scenario-test
76+
77+
[[#1765](https://github.com/cloudwego/kitex/pull/1765)] refactor: refactor generic streaming
78+
79+
### Docs
80+
[[#1794](https://github.com/cloudwego/kitex/pull/1794)] docs: update CONTRIBUTING.md to change PR base branch to main
81+
82+
### Chore
83+
[[#1795](https://github.com/cloudwego/kitex/pull/1795)] chore: update dependency
84+
85+
[[#1776](https://github.com/cloudwego/kitex/pull/1776)] chore: remove testify dependency
86+
87+
[[#1757](https://github.com/cloudwego/kitex/pull/1757)] chore: update prutal to v0.1.1
88+
89+
[[#1753](https://github.com/cloudwego/kitex/pull/1753)] ci: disable codecov annotations

‎content/en/docs/hertz/tutorials/basic-feature/sse.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,7 @@ func HandleSSE(ctx context.Context, resp *protocol.Response) error {
8484
```
8585

8686
### Example Codes
87+
8788
- [SSE](https://github.com/cloudwego/hertz-examples/tree/main/sse) : Example of hertz using SSE protocol
8889

8990
### Common Issues

‎content/zh/blog/releases/Kitex/release-v0_14_0.md‎

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
1+
---
2+
title: "Kitex Release v0.14.0"
3+
linkTitle: "Release v0.14.0"
4+
projects: ["Kitex"]
5+
date: 2025-06-26
6+
description: >
7+
---
8+
9+
## **重要变更介绍**
10+
11+
### **新特性**
12+
1. **泛化调用：泛化 Client 支持流式调用，一个 Client 搞定流式/非流式调用场景**
13+
14+
泛化 Client 支持流式泛化调用，适配 gRPC/TTHeader Streaming 并支持 map / json 和 protobuf 二进制泛化调用。
15+
16+
### **功能/体验优化**
17+
1. **Streaming： 观测/排错体验优化**
18+
19+
**TTHeader Streaming**
20+
- 若配置了 Tracer，创建 Stream 失败将打点上报
21+
- 当 Server 侧发生 panic 时，将打印完整堆栈，方便排查问题
22+
23+
**gRPC Streaming**
24+
- 若配置了 Tracer，创建 Stream 失败将打点上报
25+
26+
### **其他**
27+
1. 产物简化
28+
29+
Kitex Tool 不再生成 fastpb，只影响 protobuf 的用户。若有高性能 protobuf 编解码需求，可配置环境变量`KITEX_TOOL_USE_PRUTAL_MARSHAL=1`
30+
31+
启用 prutal。
32+
33+
## **详细变更**
34+
### Feature
35+
[[#1759](https://github.com/cloudwego/kitex/pull/1759)] feat(tool): add env for using prutal to marshal
36+
37+
[[#1782](https://github.com/cloudwego/kitex/pull/1782)] feat(ttstream): process MetaFrame and reflect to rpcinfo
38+
39+
[[#1777](https://github.com/cloudwego/kitex/pull/1777)] feat(client): report err when create Stream failed
40+
41+
[[#1763](https://github.com/cloudwego/kitex/pull/1763)] feat: support ttheader streaming generic call
42+
43+
[[#1771](https://github.com/cloudwego/kitex/pull/1771)] feat(tool): add thriftgo patcher extension
44+
45+
[[#1755](https://github.com/cloudwego/kitex/pull/1755)] feat: add generic binary pb for streamx
46+
47+
[[#1752](https://github.com/cloudwego/kitex/pull/1752)] feat(generic): support generic pb binary for streaming
48+
49+
### Optimize
50+
[[#1788](https://github.com/cloudwego/kitex/pull/1788)] optimize: go net implementation
51+
52+
[[#1786](https://github.com/cloudwego/kitex/pull/1786)] optimize(tool): remove tool fastpb generation
53+
54+
[[#1783](https://github.com/cloudwego/kitex/pull/1783)] optimize(gRPC): parse PayloadCodec in server side
55+
56+
[[#1780](https://github.com/cloudwego/kitex/pull/1780)] optimize(ttstream): log the error thrown by invoking handler
57+
58+
[[#1769](https://github.com/cloudwego/kitex/pull/1769)] optimize: injection of options in ttstream
59+
60+
### Fix
61+
[[#1792](https://github.com/cloudwego/kitex/pull/1792)] fix(gRPC): inject current method name to rpcinfo in server-side to fix FROM_METHOD missing
62+
63+
[[#1787](https://github.com/cloudwego/kitex/pull/1787)] fix(ttstream): metrics missing caused by server-side rpcinfo not set correctly
64+
65+
[[#1778](https://github.com/cloudwego/kitex/pull/1778)] fix: enabling json mode of map generic not work
66+
67+
[[#1774](https://github.com/cloudwego/kitex/pull/1774)] fix(server): trans server conn count race issue
68+
69+
[[#1742](https://github.com/cloudwego/kitex/pull/1742)] fix(generic): align dynamicgo's write base behavior with old generic (only for internal logic)
70+
71+
### Refactor
72+
[[#1770](https://github.com/cloudwego/kitex/pull/1770)] refactor: refactor generic streaming
73+
74+
### Test
75+
[[#1793](https://github.com/cloudwego/kitex/pull/1793)] test: add go1.18 to scenario-test
76+
77+
[[#1765](https://github.com/cloudwego/kitex/pull/1765)] refactor: refactor generic streaming
78+
79+
### Docs
80+
[[#1794](https://github.com/cloudwego/kitex/pull/1794)] docs: update CONTRIBUTING.md to change PR base branch to main
81+
82+
### Chore
83+
[[#1795](https://github.com/cloudwego/kitex/pull/1795)] chore: update dependency
84+
85+
[[#1776](https://github.com/cloudwego/kitex/pull/1776)] chore: remove testify dependency
86+
87+
[[#1757](https://github.com/cloudwego/kitex/pull/1757)] chore: update prutal to v0.1.1
88+
89+
[[#1753](https://github.com/cloudwego/kitex/pull/1753)] ci: disable codecov annotations

‎content/zh/docs/hertz/tutorials/basic-feature/sse.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,7 @@ func HandleSSE(ctx context.Context, resp *protocol.Response) error {
8484
```
8585

8686
### 代码示例
87+
8788
- [SSE](https://github.com/cloudwego/hertz-examples/tree/main/sse) : hertz SSE 代码示例
8889

8990
### 常见问题

0 commit comments

Comments
 (0)