此扩展程序的运作方式
使用此扩展程序可以根据写入到 Cloud Firestore 的网址创建缩短的网址。这些缩短后的网址可用作显示网址。
此扩展程序会监听您指定的 Cloud Firestore 集合。如果将一个网址添加到该集合内任何文档的指定字段中,则此扩展程序会执行以下操作:
- 缩短网址。
- 将缩短后的网址保存在同一文档的新指定的字段中。
如果文档中的原始网址发生更新,则缩短后的网址也将自动更新。
此扩展程序会使用 Bitly 缩短网址,因此您需要在此扩展程序的安装过程中提供 Bitly 访问令牌。您可以使用 Bitly 创建此访问令牌。
额外设置
在安装此扩展程序之前,请确保您已经在 Firebase 项目中设置了一个 Cloud Firestore 数据库。
在安装此扩展程序之前,您还必须拥有 Bitly 帐号和访问令牌。
结算
若要安装扩展程序,您的项目必须采用 Blaze(随用随付)方案
- 您需要为此扩展程序所需的 Firebase 资源支付少量费用(通常约为 $0.01/月),即使没有使用此扩展程序也要支付。
- 此扩展程序用到了其他 Firebase 和 Google Cloud Platform 服务,如果超出这些服务的免费层级,则会产生相关费用:
- Cloud Firestore
- Cloud Functions(Node.js 10+ 运行时。查看常见问题解答)
- 此扩展程序还使用这些服务:
- Bitly。您必须拥有 Bitly 帐号并负责支付任何相关费用。
您可以配置的内容
- Cloud Functions 位置
- Bitly 访问令牌
- 集合路径
- 网址字段名称
- 短网址字段名称
创建的资源
-
类型: Cloud Function
说明: 监听有无写入到指定 Cloud Firestore 集合中的新网址,如有,缩短这些网址,然后将缩短后的网址写回同一文档中。
如何安装此扩展程序
使用 Firebase 控制台
要安装和管理扩展程序,您可以使用 Firebase 控制台。
使用控制台安装
使用 Firebase CLI
要安装和管理扩展程序,您还可以使用 Firebase CLI:
步骤 1:运行以下 npm 命令来安装 CLI 或将 CLI 更新到最新版本。
npm install -g firebase-tools
不能运行?请参阅 Firebase CLI 参考文档或者更改您的 npm 权限。
第 2 步:设置一个新的 Firebase 项目目录或转到现有目录
第 3 步:将此扩展程序添加到扩展程序清单中
firebase ext:install firebase/firestore-shorten-urls-bitly --local --project=projectId_or_alias
第 4 步(可选):使用 Firebase Emulator Suite 在本地测试此扩展程序
firebase emulators:start
第 5 步:将清单中的扩展程序部署到项目中
firebase deploy --only extensions --project=projectId_or_alias
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]