Back to Details

fireflies-upgrade-migration

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Fireflies.ai Upgrade & Migration

Fireflies.ai 升级与迁移

Overview

概述

Guide for upgrading Fireflies.ai SDK versions and handling breaking changes.
升级Fireflies.ai SDK版本及处理破坏性变更的指南。

Prerequisites

前提条件

  • Current Fireflies.ai SDK installed
  • Git for version control
  • Test suite available
  • Staging environment
  • 已安装当前版本的Fireflies.ai SDK
  • 用于版本控制的Git
  • 可用的测试套件
  • 预发布环境

Instructions

操作步骤

Step 1: Check Current Version

步骤1：检查当前版本

bash
npm list @fireflies/sdk
npm view @fireflies/sdk version
bash
npm list @fireflies/sdk
npm view @fireflies/sdk version

Step 2: Review Changelog

步骤2：查看更新日志

bash
open https://github.com/fireflies/sdk/releases
bash
open https://github.com/fireflies/sdk/releases

Step 3: Create Upgrade Branch

步骤3：创建升级分支

bash
git checkout -b upgrade/fireflies-sdk-vX.Y.Z
npm install @fireflies/sdk@latest
npm test
bash
git checkout -b upgrade/fireflies-sdk-vX.Y.Z
npm install @fireflies/sdk@latest
npm test

Step 4: Handle Breaking Changes

步骤4：处理破坏性变更

Update import statements, configuration, and method signatures as needed.
根据需要更新导入语句、配置和方法签名。

Output

输出

  • Updated SDK version
  • Fixed breaking changes
  • Passing test suite
  • Documented rollback procedure
  • 已更新的SDK版本
  • 已修复的破坏性变更
  • 通过的测试套件
  • 已记录的回滚流程

Error Handling

错误处理

SDK VersionAPI VersionNode.jsBreaking Changes
3.x2024-0118+Major refactor
2.x2023-0616+Auth changes
1.x2022-0114+Initial release
SDK版本API版本Node.js版本破坏性变更
3.x2024-0118+重大重构
2.x2023-0616+认证方式变更
1.x2022-0114+初始版本

Examples

示例

Import Changes

导入变更

typescript
// Before (v1.x)
import { Client } from '@fireflies/sdk';

// After (v2.x)
import { Fireflies.aiClient } from '@fireflies/sdk';
typescript
// Before (v1.x)
import { Client } from '@fireflies/sdk';

// After (v2.x)
import { Fireflies.aiClient } from '@fireflies/sdk';

Configuration Changes

配置变更

typescript
// Before (v1.x)
const client = new Client({ key: 'xxx' });

// After (v2.x)
const client = new Fireflies.aiClient({
  apiKey: 'xxx',
});
typescript
// Before (v1.x)
const client = new Client({ key: 'xxx' });

// After (v2.x)
const client = new Fireflies.aiClient({
  apiKey: 'xxx',
});

Rollback Procedure

回滚流程

bash
npm install @fireflies/sdk@1.x.x --save-exact
bash
npm install @fireflies/sdk@1.x.x --save-exact

Deprecation Handling

废弃功能处理

typescript
// Monitor for deprecation warnings in development
if (process.env.NODE_ENV === 'development') {
  process.on('warning', (warning) => {
    if (warning.name === 'DeprecationWarning') {
      console.warn('[Fireflies.ai]', warning.message);
      // Log to tracking system for proactive updates
    }
  });
}

// Common deprecation patterns to watch for:
// - Renamed methods: client.oldMethod() -> client.newMethod()
// - Changed parameters: { key: 'x' } -> { apiKey: 'x' }
// - Removed features: Check release notes before upgrading
typescript
// 在开发环境中监控废弃警告
if (process.env.NODE_ENV === 'development') {
  process.on('warning', (warning) => {
    if (warning.name === 'DeprecationWarning') {
      console.warn('[Fireflies.ai]', warning.message);
      // 记录到追踪系统以便主动更新
    }
  });
}

// 需要注意的常见废弃模式：
// - 方法重命名：client.oldMethod() -> client.newMethod()
// - 参数变更：{ key: 'x' } -> { apiKey: 'x' }
// - 功能移除：升级前请查看发布说明

Resources

资源

Next Steps

后续步骤

For CI integration during upgrades, see 
fireflies-ci-integration
.
如需在升级过程中集成CI，请查看
fireflies-ci-integration
。