使用 gRPC 搭建 Flutter 应用教程

最新推荐文章于 2024-11-29 00:18:08 发布

任涌重

最新推荐文章于 2024-11-29 00:18:08 发布

阅读量453

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00602/article/details/141990393

使用 gRPC 搭建 Flutter 应用教程

flutter-grpc-tutorial[Tutorial] Asynchronous Flutter chat client with Go chat server which are powered by gRPC (simple and streaming)项目地址:https://gitcode.com/gh_mirrors/fl/flutter-grpc-tutorial

项目介绍

本教程基于 amsokol/flutter-grpc-tutorial 开源项目，旨在指导开发者如何在 Flutter 应用中集成 gRPC，实现高效的服务端和客户端通信。gRPC 是一个高性能、开源且通用的 RPC 框架，它以 Protocol Buffers 作为接口定义语言，支持多种编程语言，包括 Dart，这使得在 Flutter 这个基于 Dart 的移动开发平台上使用 gRPC成为可能。

项目快速启动

环境准备

首先，确保你的开发环境已准备好：

安装 Protobuf 编译器 (protoc)。
- 在 macOS 上，通过 Homebrew 安装：brew install protobuf。
- 其他操作系统请参照官方文档进行安装。
添加 Dart 的 protoc 插件：
```
dart pub global activate protoc_plugin
```

配置 PATH（确保 protoc 能找到插件）：

export PATH="$PATH:$HOME/.dart_tool/pub Cache/bin"

集成 Flutter 项目

更新 pubspec.yaml 添加必要的依赖：

dependencies:
  grpc: ^x.x.x // 替换为最新版本
  protobuf: ^x.x.x

创建并编译 .proto 文件。假设你在项目根目录下创建了一个 proto 文件夹，并放入了服务描述文件，如 hello.proto。运行命令来生成 Dart 代码：
```
protoc --dart_out=grpc:lib/src/services proto/hello.proto
```
初始化 gRPC 服务。在你的 Flutter 项目中，创建服务类，并在 main.dart 初始化 gRPC 渠道。

import 'package:your_grpc_package/service.pbgrpc.dart'; // 根据自动生成的包名更改

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 初始化 gRPC 客户端
  final channel = ClientChannel('localhost', port: 50051, options: const ChannelOptions(credentials: InsecureCredentials()));
  final helloService = HelloServiceClient(channel);
  
  runApp(MyApp());
}

发送第一个 gRPC 请求：

Future<void> sayHello() async {
  try {
    final request = HelloRequest()..name = '用户名称';
    final response = await helloService.sayHello(request);
    print(response.message); // 打印服务器响应
  } on GrpcError catch (e) {
    print('gRPC Error: ${e.code} - ${e.message}');
  } catch (e) {
    print('Other Error: $e');
  }
}