Commit ef5e347d authored by David Boddie's avatar David Boddie

Remove duplicate information found elsewhere in the manual

parent 4200bb77
......@@ -3,35 +3,43 @@
Introduction
=============
Apps for the Librem 5 will be typically built using the open source GTK+
toolkit. In fact many of the apps available will be ported from already
existing GTK+ apps which are part of the GNOME environment. In your efforts to
write an app or port a current app to the Librem 5, you are likely going to use
GTK+ and the tooling around it for development.
Applications (apps) for the Librem 5 will typically be built using the
`GTK+ toolkit`_. In fact many of the apps available will be ported from already
existing apps which are part of the GNOME environment. When you write an app or
port a current app to the Librem 5, you are likely going to use GTK+ and the
tooling around it for development.
The Tools
---------
- GNOME Builder
- flatpak, flatpak-builder (Your app package format)
- flatpak runtimes
See the :ref:`development_environment` chapter of this manual, and especially
the :ref:`workstation` section for an overview of the tools that make up a
typical development environment. This includes information on the following:
- `GNOME Builder`_
- ``flatpak``, ``flatpak-builder`` (Your app package format)
- Flatpak runtimes
- :ref:`Librem 5 emulator <qemu>`
- GTK+ (UI toolkit)
- `GTK+ toolkit`
- GNOME environment (Librem 5 runs GNOME by default)
- libhandy (library with GTK+ widgets for mobile phones)
- libhandy (adaptive GTK+ widget library for mobile phones)
The Workflow
------------
A typical developer workflow will involve something of this sort:
- Install flatpak and flatpak-builder
- Install GNOME Builder
- Git checkout a Gnome app to port, or start a new GNOME Application project within GNOME Builder
- Adjust dependencies for the project to pull in libhandy or other possible requirements
- Adjust project code and/or xml files for UI changes to accommodate for mobile
- Build a flatpak from GNOME Builder
- Copy flatpak into the emulator, install flatpak on emulator, run flatpak app on emulator
- Debug issues
- Rinse and repeat until your app works well on the Librem 5 emulator
- Contribute the app or port
- Install ``flatpak`` and ``flatpak-builder``.
- Install GNOME Builder.
- Checkout a GNOME app to port, or start a new GNOME application project within
GNOME Builder.
- Adjust dependencies for the project to pull in libhandy or other possible requirements.
- Adjust project code and/or XML files for UI changes to accommodate for mobile.
- Build a flatpak for the app from within GNOME Builder.
- Copy flatpak into the emulator, install and run it within the emulator.
- Debug any issues you encounter.
- Repeat until your app works well on the Librem 5 emulator.
- Test on a development board or Librem 5.
- Contribute the app or port.
.. include:: /links.rst
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment