懒猫微服 Go-SDK 使用指南

本文基于 apps-scheduler 和 cat-led 两个实际项目，介绍懒猫微服 Go-SDK 的使用方法。

SDK 简介

懒猫微服 Go-SDK（gitee.com/linakesi/lzc-sdk）是懒猫微服平台提供的 Go 语言 SDK，允许应用通过 gRPC 与懒猫微服系统交互。SDK 封装了以下核心能力：

• 应用管理（PkgManager）：查询、启动、暂停应用
• 用户管理（Users）：查询用户信息
• 设备管理（Box）：查询设备信息、控制 LED、关机/重启

项目结构

使用 Go-SDK 开发的懒猫应用推荐采用如下项目结构：

your-app/
├── cmd/
│   └── your-app/
│       └── main.go               # 应用入口
├── internal/
│   ├── web/
│   │   └── server.go             # Web 服务器配置与路由
│   ├── handlers/
│   │   ├── app.go                # SDK 调用相关 handler
│   │   └── userinfo.go           # 用户信息 handler
│   ├── biz/
│   │   └── usecase.go            # 业务逻辑与数据库操作
│   ├── auth/
│   │   └── oidc.go               # OIDC 认证
│   └── ent/
│       └── schema/               # ent ORM schema 定义
├── go.mod
├── manifest.yml                   # 懒猫应用清单
├── lzc-deploy-params.yml          # 部署参数配置（可选）
├── lzc-build.yml                  # 构建配置
└── icon.png                       # 应用图标

依赖配置

在 go.mod 中添加 SDK 依赖：