使用 Python 库

声明和管理依赖项

Python 应用的依赖项在标准 requirements.txt 文件中声明。例如：

Flask==0.10.1
google-cloud-storage

您可以在 App Engine 柔性环境中使用任何与 Linux 兼容的 Python 包，包括需要原生 (C) 扩展程序的包。

部署期间，Python 运行时将自动安装 requirements.txt 中声明的所有依赖项。

在本地安装依赖项

在本地开发和测试应用时，我们建议您使用 venv 将应用的依赖项与系统软件包隔离开来。这样做还可确保本地机器上的依赖项的版本与已部署应用的依赖项版本保持一致。

如需使用 venv 安装依赖项，请完成以下步骤：

Mac OS/Linux

注意：以下说明介绍如何在 Python 3 中设置虚拟环境。对于 Python 2 应用，请使用 virtualenv 设置虚拟环境。

1. 创建一个独立的 Python 环境：

   python3 -m venv env
   source env/bin/activate

2. 如果您当前不在包含示例代码的目录中，则导航到包含 hello_world 示例代码的目录。然后安装依赖项：

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

Windows

注意：以下说明介绍如何在 Python 3 中设置虚拟环境。对于 Python 2 应用，请使用 virtualenv 设置虚拟环境。

使用 Powershell 运行 Python 软件包。

1. 找到已安装的 Powershell。
2. 右键点击 Powershell 的快捷方式，并以管理员身份启动。
3. 创建一个独立的 Python 环境。

   python -m venv env
   .\env\Scripts\activate

4. 导航到项目目录并安装依赖项。如果您当前不在包含示例代码的目录中，则导航到包含 hello_world 示例代码的目录。然后安装依赖项：

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

现在，运行应用时，您可以确信只有 requirements.txt 中声明的依赖项可用。

提示：您经常无法确定准确的依赖项。安装依赖项后，您可以使用 pip freeze 将所有已安装软件包的名称和版本写入 requirements.txt 中。

安装 Web 框架

您需要使用 Web 框架来启用您的应用以处理 Web 请求。 您可以使用任何 Python Web 框架，包括以下各项：

• Flask
• Django
• Pyramid
• Bottle
• web.py
• Tornado

如需使用特定的 Web 框架，只需将其添加到 requirements.txt：

Flask==0.10.1

安装 WSGI 服务器

一些网络框架具有内置 WSGI 服务器，但是，这些框架基本都不适合传送生产流量。大多数 Web 应用都使用独立的 WSGI 服务器，如 Gunicorn、uWSGI 或 Waitress。如需详细了解如何安装、配置和使用 WSGI 服务器，请参阅应用启动。

安装 Google Cloud 客户端库

Python 版 Google Cloud 客户端库可用于访问 Google Cloud Platform 服务，能显著减少您必须编写的样板代码量。该库提供高级 API 抽象，因此更容易理解。该库还包含 Python 的习语，适用于标准库，并且可与您的代码库更好地集成。 这些优势意味着您可以省下更多时间来创建对您来说非常重要的代码。

要在本地安装库，请运行以下命令：

pip install google-cloud

该客户端库也可使用 Google Cloud CLI 为您在本地自动处理身份验证。

gcloud auth login