演示

Python

我们的 Python 示例使用 Flask 框架。您可以从提供的链接下载完整的源代码。

如有必要，请安装 Python 3.7 及更高版本，并确保 pip 可用。

python3 -m ensurepip --upgrade

我们还建议您设置并激活新的 Python 虚拟环境。

python3 -m venv .classroom-addon-env
source .classroom-addon-env/bin/activate

下载的示例中的每个演示文稿子目录中都有一个 requirements.txt。您可以使用 pip 快速安装所需的库。使用以下命令安装第一部分演示所需的库。

cd flask/01-basic-app
pip install -r requirements.txt

Node.js

我们的 Node.js 示例使用 Express 框架。您可以从提供的链接下载完整的源代码。

此示例需要 Node.js v16.13 或更高版本。

使用 npm 安装所需的节点模块。

npm install

Java

我们的 Java 示例使用 Spring Boot 框架。您可以从提供的链接下载完整的源代码。

如果您的机器上尚未安装 Java 11 或更高版本，请进行安装。

Spring Boot 应用可以使用 Gradle 或 Maven 来处理 build 和管理依赖项。此示例包含 Maven 封装容器，可确保成功构建，而无需您安装 Maven 本身。

在下载或克隆项目的目录中，运行以下命令，确保您具备运行项目的先决条件。

java --version
./mvnw --version

在 Windows 系统中，运行以下命令：

java -version
mvnw.cmd --version

Python

• 目录根目录包含以下文件：

  • main.py - Python 应用入口点。在该文件中指定要使用的服务器配置，然后运行该文件以启动服务器。
  • requirements.txt - 运行 Web 应用所需的 Python 模块。这些模块可以使用 pip install -r requirements.txt 自动安装。

  • client_secret.json - 从 Google Cloud 下载的客户端密钥文件。请注意，示例归档文件中不包含此文件；您应重命名下载的凭据文件，并将其复制到每个目录根目录中。

• config.py - Flask 服务器的配置选项。

• webapp 目录包含 Web 应用的内容。此软件包包含以下工具：

• /templates/ 目录，其中包含适用于各种网页的 Jinja 模板。

• 包含图片、CSS 和辅助 JavaScript 文件的 /static/ 目录。

• routes.py - Web 应用路由的处理程序方法。

• __init__.py - webapp 模块的初始化程序。此初始化程序会启动 Flask 服务器并加载在 config.py 中设置的配置选项。

• 特定演示步骤所需的其他文件。

Node.js

演示的每个步骤都可以在其自己的 <step> 子文件夹中找到。每个步骤包含：

• JavaScript、CSS 和图片等静态文件位于 ./<step>/public 文件夹中。
• 快速路由器位于 ./<step>/routes 文件夹中。
• HTML 模板位于 ./<step>/views 文件夹中。
• 服务器应用为 ./<step>/app.js。

Java

项目目录包含以下内容：

• src.main 目录包含成功运行应用所需的源代码和配置。此目录包含以下内容： + java.com.addons.spring 目录包含 Application.java 和 Controller.java 文件。Application.java 文件负责运行应用服务器，而 Controller.java 文件负责处理端点逻辑。 + resources 目录包含包含 HTML 和 JavaScript 文件的 templates 目录。它还包含用于指定运行服务器的端口、密钥库文件的路径和 templates 目录的路径的 application.properties 文件。此示例在 resources 目录中包含密钥库文件。您可以将其存储在任何位置，但请务必相应地使用路径更新 application.properties 文件。
  • pom.xml 包含构建项目和定义所需依赖项所需的信息。
  • .gitignore 包含不应上传到 Git 的文件名。请务必在此 .gitignore 中添加密钥库的路径。在提供的示例中，此值为 secrets/*.p12（下一部分将介绍密钥库的用途）。对于第 2 步和后续步骤，您还应添加 client_secret.json 文件的路径，以确保您不会在远程代码库中添加密钥。对于第 3 步及之后的演示，您应添加 H2 数据库文件和文件数据存储工厂的路径。如需详细了解如何设置这些数据存储区，请参阅有关处理回访的第 3 个演示文稿。
  • mvnw 和 mvnw.cmd 分别是适用于 Unix 和 Windows 的 Maven 封装容器可执行文件。例如，在 Unix 上运行 ./mvnw --version 会输出 Apache Maven 版本等信息。
  • .mvn 目录包含 Maven 封装容器的配置。

Python

OAuth 凭据

按照前面所述创建并下载您的 OAuth 凭据。将 JSON 文件放在根目录中，与应用的服务器启动文件放在一起。

配置服务器

您可以通过多种方式运行 Web 服务器。在 Python 文件的末尾，添加以下代码之一：

1. 不安全的 localhost。请注意，此方法仅适用于在浏览器窗口中直接进行测试；无法在 Google 课堂插件 iframe 中加载不安全的网域。

   if __name__ == "__main__":
     # Disable OAuthlib's HTTPs verification.
     os.environ["OAUTHLIB_INSECURE_TRANSPORT"] = "1"
   
     # Run the web app at http://localhost:5000.
     app.run(debug=True)
   

2. 锁定localhost。您必须为 ssl_context 参数指定一个 SSL 密钥文件元组。

   if __name__ == "__main__":
     # Run the web app at https://localhost:5000.
     app.run(host="localhost",
             ssl_context=("localhost.pem", "localhost-key.pem"),
             debug=True)
   

3. Gunicorn 服务器。这适用于生产就绪的服务器或云部署。我们建议您设置 PORT 环境变量，以便与此启动选项搭配使用。

   if __name__ == "__main__":
     # Run the web app at https://<your domain>:<server_port>.
     # Defaults to https://<your domain>:8080.
     server_port = os.environ.get("PORT", "8080")
     app.run(debug=True, port=server_port, host="0.0.0.0")
   

启动服务器

运行 Python 应用，以按照上一步中配置的方式启动服务器。

python main.py

点击显示的网址，在浏览器中查看您的 Web 应用，以确认其是否正常运行。

Node.js

配置服务器

如需通过 HTTPS 运行服务器，您需要创建一个用于通过 HTTPS 运行应用的自签名证书。这些凭据应保存为代码库根目录中的 sslcert/cert.pem 和 sslcert/key.pem。您可能需要将这些密钥添加到操作系统密钥串中，以便浏览器接受它们。

请确保 *.pem 位于 .gitignore 文件中，因为您不想将该文件提交到 Git。

启动服务器

您可以使用以下命令运行应用，将 step01 替换为您要作为服务器运行的正确步骤（例如，将 step01 替换为 01-basic-app，将 step02 替换为 02-sign-in）。

npm run step01

或

npm run step02

这会在 https://localhost:5000 启动 Web 服务器。

您可以在终端中使用 Control + C 终止服务器。

Java

配置服务器

如需通过 HTTPS 运行服务器，您需要创建一个用于通过 HTTPS 运行应用的自签名证书。

考虑使用 mkcert 进行本地开发。安装 mkcert 后，以下命令会生成一个本地存储的证书，以便通过 HTTPS 运行。

mkcert -install
mkcert -pkcs12 -p12-file <path_to_keystore> <domain_name>

此示例在 resources 目录中包含密钥库文件。您可以将其存储在任何位置，但请务必相应地使用路径更新 application.properties 文件。域名是您运行项目的网域（例如 localhost）。

请确保 *.p12 位于 .gitignore 文件中，因为您不想将该文件提交到 Git。

启动服务器

通过在 Application.java 文件中运行 main 方法来启动服务器。例如，在 IntelliJ 中，您可以右键点击 src/main/java/com/addons/spring 目录中的 Application.java > Run 'Application'，也可以打开 Application.java 文件，然后点击 main(String[] args) 方法签名左侧的绿色箭头。或者，您也可以在终端窗口中运行项目：

./mvnw spring-boot:run

或者在 Windows 上：

mvnw.cmd spring-boot:run

这会在 https://localhost:5000 或您在 application.properties 中指定的端口启动服务器。