BeeWare峰器中文文档教程6开始这个（第三方）

到目前为止&＃xff0c;我们构建的应用程序只使用了我们自己的代码&＃xff0c;加上 BeeWare 提供的代码。但是&＃xff0c;在实际应用中&＃xff0c;您可能希望使用从 Python 包索引 (PyPI) 下载的第三方库。

让我们修改我们的应用程序以包含第三方库。

访问 API
应用程序需要执行的一项常见任务是在 Web API 上发出请求以检索数据&＃xff0c;并将该数据显示给用户。这是一个玩具应用程序&＃xff0c;所以我们没有真正的API 可以使用&＃xff0c;所以我们将使用{JSON} Placeholder API作为数据源。

{JSON} 占位符 API 有许多可以用作测试数据的“假”API 端点。这些 API 之一是/posts/端点&＃xff0c;它返回虚假的博客文章。如果您https://jsonplaceholder.typicode.com/posts/42在浏览器中打开&＃xff0c;您将获得描述单个帖子的 JSON 有效负载 - ID 为 42 的博客帖子的一些Lorum ipsum内容。

Python 标准库包含访问 API 所需的所有工具。但是&＃xff0c;内置 API 的级别非常低。它们是 HTTP 协议的良好实现——但它们需要用户管理许多低级细节&＃xff0c;例如 URL 重定向、会话、身份验证和有效负载编码。作为“普通浏览器用户”&＃xff0c;您可能习惯于将这些细节视为理所当然&＃xff0c;因为浏览器会为您管理这些细节。

因此&＃xff0c;人们开发了第三方库&＃xff0c;这些库封装了内置 API&＃xff0c;并提供了更简单的 API&＃xff0c;更接近日常浏览器体验。我们将使用其中一个库来访问 {JSON} Placeholder API - 一个名为httpx的库。

让我们向我们的应用程序添加一个httpxAPI 调用。app.py在to import的顶部添加一个 导入httpx&＃xff1a;

import httpx

然后修改say_hello()回调&＃xff0c;使其看起来像这样&＃xff1a;

def say_hello(self, widget):if self.name_input.value:name &＃61; self.name_input.valueelse:name &＃61; &＃39;stranger&＃39;with httpx.Client() as client:response &＃61; client.get("https://jsonplaceholder.typicode.com/posts/42")payload &＃61; response.json()self.main_window.info_dialog("Hello, {}".format(name),payload["body"],)

这将更改say_hello()回调&＃xff0c;以便在调用它时&＃xff0c;它将&＃xff1a;

在 JSON 占位符 API 上发出 GET 请求以获取帖子 42&＃xff1b;

• 将响应解码为 JSON&＃xff1b;
• 提取帖子的正文&＃xff1b;和
• 包括该帖子的正文作为对话框的文本。

让我们在公文包开发者模式下运行我们更新的应用程序&＃xff0c;以检查我们的更改是否有效。

苹果系统

(beeware-venv) $ briefcase dev
Traceback (most recent call last):
File ".../venv/bin/briefcase", line 5, in from briefcase.__main__ import main
File ".../venv/lib/python3.9/site-packages/briefcase/__main__.py", line 3, in from .cmdline import parse_cmdline
File ".../venv/lib/python3.9/site-packages/briefcase/cmdline.py", line 6, in from briefcase.commands import DevCommand, NewCommand, UpgradeCommand
File ".../venv/lib/python3.9/site-packages/briefcase/commands/__init__.py", line 1, in from .build import BuildCommand # noqa
File ".../venv/lib/python3.9/site-packages/briefcase/commands/build.py", line 5, in from .base import BaseCommand, full_options
File ".../venv/lib/python3.9/site-packages/briefcase/commands/base.py", line 14, in import httpx
ModuleNotFoundError: No module named &＃39;httpx&＃39;

Linux

(beeware-venv) $ briefcase dev
Traceback (most recent call last):
File ".../venv/bin/briefcase", line 5, in from briefcase.__main__ import main
File ".../venv/lib/python3.9/site-packages/briefcase/__main__.py", line 3, in from .cmdline import parse_cmdline
File ".../venv/lib/python3.9/site-packages/briefcase/cmdline.py", line 6, in from briefcase.commands import DevCommand, NewCommand, UpgradeCommand
File ".../venv/lib/python3.9/site-packages/briefcase/commands/__init__.py", line 1, in from .build import BuildCommand # noqa
File ".../venv/lib/python3.9/site-packages/briefcase/commands/build.py", line 5, in from .base import BaseCommand, full_options
File ".../venv/lib/python3.9/site-packages/briefcase/commands/base.py", line 14, in import httpx
ModuleNotFoundError: No module named &＃39;httpx&＃39;

视窗
 

(beeware-venv)C:\...>briefcase dev
Traceback (most recent call last):
File "...\venv\bin\briefcase", line 5, in from briefcase.__main__ import main
File "...\venv\lib\python3.9\site-packages\briefcase\__main__.py", line 3, in from .cmdline import parse_cmdline
File "...\venv\lib\python3.9\site-packages\briefcase\cmdline.py", line 6, in from briefcase.commands import DevCommand, NewCommand, UpgradeCommand
File "...\venv\lib\python3.9\site-packages\briefcase\commands\__init__.py", line 1, in from .build import BuildCommand  # noqa
File "...\venv\lib\python3.9\site-packages\briefcase\commands\build.py", line 5, in from .base import BaseCommand, full_options
File "...\venv\lib\python3.9\site-packages\briefcase\commands\base.py", line 14, in import httpx
ModuleNotFoundError: No module named &＃39;httpx&＃39;

发生了什么&＃xff1f;我们已经添加httpx到我们的代码中&＃xff0c;但我们还没有将它添加到我们的开发虚拟环境中。我们可以通过安装来解决这个问题httpx &＃xff0c;pip然后重新运行&＃xff1a;briefcase dev

苹果系统

(beeware-venv) $ python -m pip install httpx
(beeware-venv) $ briefcase dev

Linux

(beeware-venv) $ python -m pip install httpx
(beeware-venv) $ briefcase dev

视窗

(beeware-venv)C:\...>python -m pip install httpx
(beeware-venv)C:\...>briefcase dev

当您输入名称并按下按钮时&＃xff0c;您应该会看到一个类似于以下内容的对话框&＃xff1a;

Hello World 教程 6 对话框&＃xff0c;在 Windows 上
我们现在有了一个可以工作的应用程序&＃xff0c;使用第三方库&＃xff0c;在开发模式下运行&＃xff01;

运行更新的应用程序
让我们将这个更新的应用程序代码打包为一个独立的应用程序。由于我们已经进行了代码更改&＃xff0c;我们需要按照教程 4 中的相同步骤进行操作&＃xff1a;

苹果系统

更新打包应用程序中的代码&＃xff1a;(beeware-venv) $ briefcase update[hello-world] Updating application code...
Installing src/hello_world...[hello-world] Application updated.
重建应用程序&＃xff1a;(beeware-venv) $ briefcase build[hello-world] Building AppImage...
...
[hello-world] Built linux/Hello_World-0.0.1-x86_64.AppImage
最后&＃xff0c;运行应用程序&＃xff1a;(beeware-venv) $ briefcase run[hello-world] Starting app...
但是&＃xff0c;当应用程序运行时&＃xff0c;您会看到一个崩溃对话框&＃xff1a;

Linux


更新打包应用程序中的代码&＃xff1a;(beeware-venv) $ briefcase update[hello-world] Updating application code...
Installing src/hello_world...[hello-world] Application updated.
重建应用程序&＃xff1a;(beeware-venv) $ briefcase build[hello-world] Building AppImage...
...
[hello-world] Built linux/Hello_World-0.0.1-x86_64.AppImage
最后&＃xff0c;运行应用程序&＃xff1a;(beeware-venv) $ briefcase run[hello-world] Starting app...Traceback (most recent call last):File "/tmp/.mount_Hello_ifthSH/usr/lib/python3.8/runpy.py", line 194, in _run_module_as_mainreturn _run_code(code, main_globals, None,File "/tmp/.mount_Hello_ifthSH/usr/lib/python3.8/runpy.py", line 87, in _run_codeexec(code, run_globals)File "/tmp/.mount_Hello_ifthSH/usr/app/hello_world/__main__.py", line 1, in from hello_world.app import mainFile "/tmp/.mount_Hello_ifthSH/usr/app/hello_world/app.py", line 8, in import httpx
ModuleNotFoundError: No module named &＃39;httpx&＃39;Unable to start app hello-world.

视窗

更新打包应用程序中的代码&＃xff1a;(beeware-venv)C:...>公文包更新[hello-world] 正在更新应用程序代码…正在安装 src/hello_world…[hello-world] 应用程序已更新。重建应用程序&＃xff1a;(beeware-venv)C:\...>briefcase build[hello-world] Built windows/msi/Hello World
最后&＃xff0c;运行应用程序&＃xff1a;(beeware-venv)C:\...>briefcase run[hello-world] Starting app...Unable to start app hello-world.

再次&＃xff0c;该应用程序无法启动&＃xff0c;因为httpx已安装 - 但为什么呢&＃xff1f;我们不是已经安装了httpx吗&＃xff1f;

我们有——但仅限于开发环境。您的开发环境完全在您的机器本地 - 只有在您明确激活它时才会启用。虽然公文包有一种开发模式&＃xff0c;但您使用公文包的主要原因是打包您的代码&＃xff0c;以便您可以将其提供给其他人。

保证其他人将拥有一个包含所需一切的 Python 环境的唯一方法是构建一个完全隔离的 Python 环境。这意味着有一个完全隔离的 Python 安装和一组完全隔离的依赖项。这就是公文包在运行时正在构建的东西——一个孤立的 Python 环境。这也解释了为什么没有安装 - 它已安装在您的开发 环境中&＃xff0c;但未安装在打包的应用程序中。briefcase buildhttpx

所以 - 我们需要告诉公文包我们的应用程序有一个外部依赖项。

更新依赖项
在您的应用程序的根目录中&＃xff0c;有一个名为pyproject.toml. 此文件包含您最初运行时提供的所有应用程序配置详细信息。briefcase new

pyproject.toml被分成几个部分&＃xff1b;其中一个部分描述了您的应用程序的设置&＃xff1a;

[tool.briefcase.app.hello-world]
formal_name &＃61; "Hello World"
description &＃61; "A Tutorial app"
icon &＃61; "src/hello_world/resources/hello-world"
sources &＃61; [&＃39;src/hello_world&＃39;]
requires &＃61; []

该requires选项描述了我们应用程序的依赖关系。它是一个字符串列表&＃xff0c;指定要包含在应用程序中的库&＃xff08;以及可选的版本&＃xff09;。

修改requires设置&＃xff0c;使其显示为&＃xff1a;

requires &＃61; ["httpx",
]

通过添加这个设置&＃xff0c;我们告诉公文包“当你构建我的应用程序时&＃xff0c;运行 到应用程序包中”。可以在此处使用任何合法输入的内容- 因此&＃xff0c;您可以指定&＃xff1a;pip install httpxpip install

• 特定的库版本&＃xff08;例如&＃xff0c;"httpx&＃61;&＃61;0.19.0"&＃xff09;&＃xff1b;
• 一系列库版本&＃xff08;例如&＃xff0c;"httpx>&＃61;0.19"&＃xff09;&＃xff1b;
• git 存储库的路径&＃xff08;例如&＃xff0c;"git&＃43;https://github.com/encode/httpx"&＃xff09;&＃xff1b;或者
• 本地文件路径&＃xff08;但是 - 请注意&＃xff1a;如果您将代码提供给其他人&＃xff0c;则此路径可能不会存在于他们的机器上&＃xff01;&＃xff09;

再往下pyproject.toml看&＃xff0c;您会注意到与操作系统相关的其他部分&＃xff0c;例如[tool.briefcase.app.hello-world.macOS]和 [tool.briefcase.app.hello-world.windows]。这些部分也有一个 requires设置。这些设置允许您定义其他特定于平台的依赖项 - 例如&＃xff0c;如果您需要特定于平台的库来处理应用程序的某些方面&＃xff0c;您可以在特定于平台的requires部分中指定该库&＃xff0c;并且该设置只会用于该平台。您会注意到这些toga库都在特定于平台的requires部分中指定 - 这是因为显示用户界面所需的库是特定于平台的。

在我们的例子中&＃xff0c;我们希望httpx安装在所有平台上&＃xff0c;所以我们使用应用级别requires设置。将始终安装应用级别的依赖项&＃xff1b;除了应用程序级别的依赖项之外&＃xff0c;还安装了特定于平台的依赖项。

• 仅在移动设备上使用 Python&＃xff08;目前&＃xff01;&＃xff09;
• 在桌面平台&＃xff08;macOS、Windows、Linux&＃xff09;上&＃xff0c;任何pip-installable 都可以添加到您的要求中。在移动平台上&＃xff0c;您的选择更加有限——您只能使用纯 Python包&＃xff0c;即不包含二进制模块的包。
• 这意味着像numpy、scikit-learn或 之类的库cryptography可以在桌面应用程序中使用&＃xff0c;但不能在移动应用程序中使用。这主要是因为移动应用程序需要为多个平台编译的二进制模块&＃xff0c;这很难设置。
• 可以构建一个使用二进制模块的移动 Python 应用程序&＃xff0c;但设置起来并不容易——远远超出了像这样的介绍性教程的范围。这是我们想要解决的一个领域——但这不是一项简单的任务。如果您希望将其添加到 BeeWare&＃xff0c;请考虑通过成为会员来支持该项目。

现在我们已经告诉公文包我们的附加依赖项&＃xff0c;我们可以尝试再次打包我们的应用程序。确保您已将更改保存到 pyproject.toml&＃xff0c;然后再次更新您的应用程序 - 这次是传入 -d标志。这告诉公文包更新打包应用程序中的依赖项&＃xff1a;

苹果系统

(beeware-venv) $ briefcase update -d[hello-world] Updating dependencies...
Collecting httpxUsing cached httpx-0.19.0-py3-none-any.whl (77 kB)
...
Installing collected packages: sniffio, idna, travertino, rfc3986, h11, anyio, toga-core, rubicon-objc, httpcore, charset-normalizer, certifi, toga-cocoa, httpx
Successfully installed anyio-3.3.2 certifi-2021.10.8 charset-normalizer-2.0.6 h11-0.12.0 httpcore-0.13.7 httpx-0.19.0 idna-3.2 rfc3986-1.5.0 rubicon-objc-0.4.1 sniffio-1.2.0 toga-cocoa-0.3.0.dev28 toga-core-0.3.0.dev28 travertino-0.1.3[hello-world] Updating application code...
Installing src/hello_world...[hello-world] Application updated.

Linux

(beeware-venv) $ briefcase update -d[hello-world] Updating dependencies...
Collecting httpxUsing cached httpx-0.19.0-py3-none-any.whl (77 kB)
...
Installing collected packages: sniffio, idna, travertino, rfc3986, h11, anyio, toga-core, rubicon-objc, httpcore, charset-normalizer, certifi, toga-cocoa, httpx
Successfully installed anyio-3.3.2 certifi-2021.10.8 charset-normalizer-2.0.6 h11-0.12.0 httpcore-0.13.7 httpx-0.19.0 idna-3.2 rfc3986-1.5.0 rubicon-objc-0.4.1 sniffio-1.2.0 toga-cocoa-0.3.0.dev28 toga-core-0.3.0.dev28 travertino-0.1.3[hello-world] Updating application code...
Installing src/hello_world...[hello-world] Application updated.

视窗

(beeware-venv)C:\...>briefcase update -d[hello-world] Updating dependencies...
Collecting httpxUsing cached httpx-0.19.0-py3-none-any.whl (77 kB)
...
Installing collected packages: sniffio, idna, travertino, rfc3986, h11, anyio, toga-core, rubicon-objc, httpcore, charset-normalizer, certifi, toga-cocoa, httpx
Successfully installed anyio-3.3.2 certifi-2021.10.8 charset-normalizer-2.0.6 h11-0.12.0 httpcore-0.13.7 httpx-0.19.0 idna-3.2 rfc3986-1.5.0 rubicon-objc-0.4.1 sniffio-1.2.0 toga-cocoa-0.3.0.dev28 toga-core-0.3.0.dev28 travertino-0.1.3[hello-world] Updating application code...
Installing src/hello_world...[hello-world] Application updated.

更新后&＃xff0c;您可以运行并且- 您应该会看到打包的应用程序以及新的对话框行为。briefcase buildbriefcase run

下一步
我们现在有了一个使用第三方库的应用程序&＃xff01;但是&＃xff0c;您可能已经注意到&＃xff0c;当您按下按钮时&＃xff0c;应用程序变得有点反应迟钝。我们能做些什么来解决这个问题吗&＃xff1f;转到教程 7以了解...