玩玩 Google Codelabs

Posted 2023-05-16

参考技术A

最近，我所在的测开团队，有意使用统一的文档工具，并给我提供了一个关键词，那就是：

（以 macOS 为例）
1）安装 GO 语言；
命令行依次执行命令：

2）安装 Node.js v10+；
安装 nodejs (以安装 v14 为例)：

环境变量设置：

如果使用 zsh 终端，则:

1）clone 项目；

2）安装项目依赖；

3）安装 Codelabs command line tool；

4) 安装 Codelabs command line tool 的依赖；

5) 验证 claat 是否设置正确；

1）Example - 本地文件式浏览页面；

执行完成后悔生成一个新文件夹，双击打开文件夹下的 index.html 就可以以本地方式打开 example；

2）Example - web serve 式浏览页面；

执行完成后会自动在浏览器上打开页面：

点击页面上的 “codelab-4-codelab-markdown” 就可以浏览 example 页面了；

不过截止目前位置，都还是直接浏览文件，不像一个文档空间，咱们继续学习~

1）在项目下创建自己的文件夹，名字随意，如：codelabs；
2）在 codelabs 下创建 .md 文件，也可以在 codelabs 下再建文件夹，例如： codelabs/test/hello.md；
3）在 codelabs/test/hello.md 内按 codelabs 的格式要求（后续介绍），编写页面内容，如：

4）“编译” codelabs/test/hello.md 文件；

5）在 site/app/views 底下创建 codelabs 文件夹，然后拷贝 codelabs 文件夹下的内容至 site/app/views/codelabs 文件夹下；

6）本地部署 codelabs 站点；

7）访问本地 codelabs 站点；
浏览器访问站点： http://localhost:8000

8）将上述命令行操作简化；

这样，本地部署，我们就只需要执行一个命令即可：

到此为止，我们已基本完成了第一个 codelabs 页面的开发和本地部署，成功已近在咫尺，继续加油！

官方参考文档： https://github.com/googlecodelabs/tools/blob/main/site/README.md
1）修改主页布局、logo、文字内容等；
修改 site/app/views/default/index.html 和 site/app/views/default/view.json 文件，特别是 site/app/views/default/index.html 文件，读者可自行修改、验证；

2）类别；

site/app/views 底下创建自己的文件夹，文件夹下创建 view.json，并按照规则编写 view.json 文件，如 site/app/views/inwebinar/view.json

页面中，若使用到图片、文件等，我们可以考虑使用 Minio 对象存储服务，这块在上一篇文章中已介绍，详情请见：

好了，codelabs 的基本情况我们都摸了一遍，今天就到此为止吧，下一篇文章，我们尽可能来学习一下基于 vuepress 的文档工具，欢迎留意~

中国可以访问 Google Codelabs 网站啦！

今天，Google 官方又宣布了一条信息「全球皆可访问的 Google Codelabs 网站」，说是全球，其实我们大家心里都明白，这是针对中国开发者而专门发布的一个网站，最近 Google 针对中国开发者动作不断，让人又是惊喜又是期待啊。

说起 Google Codelabs 可能有些人没了解过，其实全称应该叫 Google Developers Codelabs，翻译过来就是谷歌开发者代码实验室，说白了，这个网站提供了一些官方学习示例，用指导、教程的方式，一步步引导你学习 Google 的一些技术，为你提供了一个很棒的实际编程体验，涉及的范围有 Android、Firebase、loT、Nest、VR 等，它大概长这样子：

你可以直接在上面选择「Category」来查找你感兴趣的资源类别，点进去其中一个教程之后会看到这样的一步一步、手把手教你的教程：

不得不说，如果你英语还可以的话，Codelabs 上是一份很棒的学习资源，可惜的是，由于众所周知的原因，它的原地址：

https://codelabs.developers.google.com/

在国内访问不了，但是今天任何人都可以直接访问 Codelabs，学习上面的教程了，地址是：

http://clmirror.storage.googleapis.com/index.html

真是喜大普奔啊，小伙伴们值得奔走相告，期待越来越多的 Google 服务逐步开放出来。

本文原创发布于微信公众号 AndroidDeveloper，欢迎关注获取更多原创分享。