目录
创建一个新的BeeWare项目（ Hello World! ）
BeeWare 是一个开源项目，旨在帮助开发者使用 Python 创建原生应用程序，覆盖了移动、桌面和 Web 平台。BeeWare 通过提供一系列工具和库，使得开发者可以利用 Python 的简洁和强大来构建跨平台的应用程序，而无需学习其他语言或工具。
BeeWare 包括以下主要组件和工具：
-
Toga：Toga 是一个用于创建原生桌面应用程序的 Python 框架，支持多个平台，包括 macOS、Windows 和 Linux。它提供了丰富的 UI 组件和布局管理器，以及与平台原生控件的无缝集成，使得开发者可以轻松地构建具有原生外观和感觉的应用程序。
-
Briefcase：Briefcase 是一个用于将 Python 应用程序打包为可执行文件的工具。它支持将 Python 代码转换为原生的移动应用程序（如 Android APK 和 iOS 应用）、桌面应用程序（如 Windows 可执行文件和 macOS 应用）以及 Web 应用程序，从而让开发者能够将他们的 Python 代码发布到各种不同的平台上。
-
Rubicon-ObjC 和 Rubicon-Java：这是两个用于在 Python 中调用 Objective-C 和 Java 代码的库，使得开发者能够利用现有的 Objective-C 和 Java 库来扩展他们的 Python 应用程序，从而实现更多的功能和特性。
-
Batavia：Batavia 是一个用于在浏览器中运行 Python 代码的项目，它通过将 Python 代码转换为 JavaScript 来实现跨平台的支持。这使得开发者可以编写一次 Python 代码，然后在 Web 浏览器中运行，而无需改变任何代码。
通过 BeeWare，开发者可以使用熟悉的 Python 语言和工具来构建原生应用程序，而无需学习其他语言或工具。这为 Python 社区的开发者提供了一个更广阔的舞台，让他们能够参与到移动应用、桌面应用和 Web 应用的开发中。
创建BeeWare虚拟环境
在工程文件夹下继续以下代码，创建beeware虚拟环境并激活。当然这一步也可以用conda等实现。（以下代码为Windows 命令行窗口创建虚拟环境的例子。）
md beeware-tutorial
cd beeware-tutorial
py -m venv beeware-venv
beeware-venv\Scripts\activateBeeWare 的官方网站提供了丰富的文档、示例代码和社区支持，帮助开发者快速上手并解决问题。如果你对使用 Python 构建原生应用程序感兴趣，不妨了解一下 BeeWare，它可能会成为你的理想选择。
配置BeeWare
激活虚拟环境后，pip下载相关包体（注意，根据官方说法，建议采用python -m操作，以便自动更新）。
python -m pip install briefcase创建一个新的BeeWare项目（ Hello World! ）
下载完毕后，即可开始创建一个新的项目了！使用以下方法：
briefcase new随后将出现以下几个项目初始化设置（直接回车将采用方括号里的内容）：
- Formal Name [Hello World]:（填入项目名称，该处是展示给用户的名称。）
- App Name [helloworld]: （对应的项目名称，该处是提供给机器编译所需的名称）
- Bundle Identifier [com.example]: （应用商店标识，如果没有直接回车跳过此条目。）
- Project Name [Hello World]: （Briefcase提供了多应用管理，如果此项目只有一个应用，可以采用与Formal Name 一致的名称。）
- Description [My first application]: （填写应用的一行描述。）
- Author [Jane Developer]: （应用开发作者署名）
- Author's Email [[email protected]]: （作者联系邮箱）
- Application URL [https://example.com/helloworld]: （未来的应用发布页网址）
- Project License [1]: （根据提示选取应用开源协议，当然也可以选择其他不开源的协议）
- GUI Framework [1]: （选择GUI框架，可选[1]Toga, [2]PySide6, [3]PursuedPyBear, [4]Pygame 或无GUI [5]None .其中仅[1]Toga支持ios/android平台的打包分发。）
注意，在该步骤中需要保证git clone能够正常连接，也即第三部分配置成功。
尝试 Hello World 样例
在完成上一部分的新建项目后，会有以下提示：
[helloworld] Generating a new application 'Hello World'
Using app template: https://github.com/beeware/briefcase-template, branch v0.3.17
[helloworld] Generated new application 'Hello World'
To run your application, type:
$ cd helloworld
$ briefcase dev我们可以发现，Briefcase在当前目录下新建了一个helloworld文件夹（App Name），若要以开发者身份运行此应用，则需要：
cd helloworld
briefcase dev当使用 BeeWare 的 Toga 框架时，你可以使用 Python 编写代码来创建原生桌面应用程序。以下是一个简单的示例，演示了如何使用 Toga 创建一个包含按钮和标签的桌面应用程序：
import toga
def button_handler(widget):
label.text = 'Hello, BeeWare!'
def build(app):
box = toga.Box()
# 创建一个按钮
button = toga.Button('Click me', on_press=button_handler)
# 创建一个标签
global label
label = toga.Label('Welcome to BeeWare!')
box.add(button)
box.add(label)
# 创建窗口
main_window = toga.MainWindow(title=app.name)
main_window.content = box
return main_window
def main():
# 创建并运行应用程序
app = toga.App('MyFirstApp', 'org.example.myfirstapp', startup=build)
app.main_loop()
if __name__ == '__main__':
main()
在这个示例中，我们首先导入了 toga 模块，然后定义了一个按钮的事件处理函数 button_handler 和一个应用程序的构建函数 build。在 build 函数中，我们创建了一个 Box 容器，并向其中添加了一个按钮和一个标签。最后，我们创建了一个主窗口，并将 Box 容器设置为其内容，从而构建了一个基本的桌面应用程序界面。
当你运行这个示例时，它将会启动一个简单的桌面应用程序窗口，包含一个按钮和一个标签。当你点击按钮时，标签的文本将会变成“Hello, BeeWare!”。
这只是一个简单的示例，Toga 提供了许多其他丰富的 UI 组件和布局管理器，以及与平台原生控件的无缝集成，使得你可以构建具有原生外观和感觉的应用程序。同时，BeeWare 还提供了 Briefcase 工具，可以帮助你将 Python 应用程序打包为可执行文件，以便在不同的平台上发布和运行。
