[[:oktatas:programozás:python:beeware|< BeeWare]]

====== BeeWare ======

  * **Szerző:** Sallai András
  * Copyright (c) 2020, Sallai András, 2020
  * Licenc: [[https://creativecommons.org/licenses/by-sa/4.0/|CC BY-SA 4.0]]
  * Web: https://szit.hu

===== A BeeWare =====

A BeeWare egy eszközökgyűjtemény és programozói könyvtár. 
Keresztplatformos, natív Python GUI alakalmazások 
írására alkalmas.

A következőket tartalmazza:
  * Toga: Keresztplatformos widget eszközkészlet.
  * Briefcase: Python projekt csomagoló.
  * Rubicon ObjC: programozói könyvtár.
    * Objektiv C programozói könyvtár iOS és macOS-re Python kódon belül.
  * Rubicon Java: együtműkdöés Java könyvtárakkal együtt Python kódon belül.

A teljes BeeWare megoldás magában foglal szoftverfejlesztő eszközöket és
alkalmazásokat, amely a BeeWare saját programozói könyvtárával lett írva.

A BeeWare megoldás elérhető macOS, Window, Linux (GTK használattal),
mobli platformokon, mint Android és iOS; és a web.


===== Telepítés =====

Előszöris szükség van egy Pythonra.

Debian GNU/Linux 10:
  apt install python3

Windowson:
  * https://www.python.org/downloads/


===== Függőségek telepítése ===== 
<code>
apt install git \
  python3-dev \
  python3-venv \
  libgirepository1.0-dev \
  libcairo2-dev \
  libpango1.0-dev \
  libwebkit2gtk-4.0-37 \
  gir1.2-webkit2-4.0
</code>

Windowson:
  * Telepítsünk Gitet: https://git-scm.com/download/
  * WiX Toolsetet: https://wixtoolset.org/releases/


===== Virtuális környezet beállítása =====

Célszerű virtuális környezetben dolgozni, így nem keverjük a rendszer
könyvtáraival a letöltött eszközöket. Az így elkészülő könyvtárat
bármikor törölhetjük.

Linuxon:
<code>
$ mkdir beeware-tutorial
$ cd beeware-tutorial
$ python3 -m venv beeware-venv
$ source beeware-venv/bin/activate
</code>

windowson:
<code>
C:\...>md beeware-tutorial
C:\...>cd beeware-tutorial
C:\...>py -m venv beeware-venv
C:\...>beeware-venv\Scripts\activate.bat
</code>

  * A **python3 -m venv beeware-venv** parancs elkészíti a virtuális környezetet
  * A **source beeware-venv/bin/activate** parancs aktiválja a virtuális környezetet.


===== BeeWare eszközök telepítése ====

Linuxon:
<code>
(beeware-venv) $ python -m pip install briefcase
</code>

Windowson:
<code>
(beeware-venv)C:\...>python -m pip install briefcase
</code>

===== Új projekt =====

Linuxon:
<code>
(beeware-venv) $ briefcase new
</code>

Windowson:
<code>
(beeware-venv) C:\...>briefcase new
</code>


A briefcase egy sor kérdést tesz fel:

  * **Formal Name**: fogadjuk el az alapértelmezést: Hello World
  * **App Name**: fogadjuk el az alapértelmezést: Helloworld
  * **Bundle**: Ha van saját domained, írd be. Például hu.valami
  * **Project Name**: fogadjuk el az alapértelmezést: Hello World
  * **Description**: fogadjukl el az alapértelmezést.
  * **Author**: írja be saját nevét.
  * **Author's email**: írjuk be az e-mail címünket.
  * **URL**: írjuk be az alkalmazás leendő webhelyét.
  * **License**: fogadjuk el az alapértelmezést (BSD)
  * **GUI framework**: fogadjuk el az alapértelmezést (Toga)

Ehhez haosnló könyvtárszerkezetet kapunk:
<code>
beeware-tutorial/
    beeware-venv/
        ...
    helloworld/
        LICENSE
        README.rst
        pyproject.toml
        src/
            helloworld/
                resources/
                    helloworld.icns
                    helloworld.ico
                    helloworld.png
                __init__.py
                __main__.py
                app.py
</code>

===== Futtatás fejlesztői módban =====

<code>
(beeware-venv) $ cd helloworld
(beeware-venv) $ briefcase dev
</code>

===== Forrás =====
  * https://docs.beeware.org/en/latest/tutorial/tutorial-1.html (2020)