Requirement for Developing

[ZX Spectrum]

Hello.
I would like to know what tools, books I need to learn in order to start developing apps for the PinePhone Pro ?
as a background about my experties, I am:
- very good at Java. (regular desktop applications)
- very good at SQL (probably irrelevant) 
- I am OK with Linux bash shell (no shell scripts though )
- very good with Operating Systems design concepts (theory only from university courses)
- no experience at all in user interface design (well I know Java swing at least)

I really appreciate detailed guidance and direct resources.
I prefer reading books over scavenging from badly written blogs  and tutorials

  thanks

[barray]

You can already develop apps using Java and SQL. Rather than waste time stuck in the theory, get stuck in and find out what you don't know.

Ideally you find an app/problem that you personally would like to see solved, doesn't already exist and is simple (simplicity is important).

Some ideas to get started:

* A phone friendly calculator (whilst basic mathematics is not hard, think of it as a learning exercise for properly designing UI)
* A simple image editor (I believe it's still the case that the phone doesn't always take well colour adjusted photos and user adjustment would be nice)
* An alarm clock (think about a simple UI, setting timers, awaking the phone whilst in a 'sleep' mode, setting tones, etc)

Remember that there is a community to help, but also try to solve the problems yourself where possible.

If you can build these then I think you are in a good place to start working on more complex apps.

[ZX Spectrum]

You can already develop apps using Java and SQL. Rather than waste time stuck in the theory, get stuck in and find out what you don't know.

Ideally you find an app/problem that you personally would like to see solved, doesn't already exist and is simple (simplicity is important).

Some ideas to get started:

* A phone friendly calculator (whilst basic mathematics is not hard, think of it as a learning exercise for properly designing UI)
* A simple image editor (I believe it's still the case that the phone doesn't always take well colour adjusted photos and user adjustment would be nice)
* An alarm clock (think about a simple UI, setting timers, awaking the phone whilst in a 'sleep' mode, setting tones, etc)

Remember that there is a community to help, but also try to solve the problems yourself where possible.

If you can build these then I think you are in a good place to start working on more complex apps.

thank you for the replay barray but I think you got me wrong.
I am not asking for project suggestions. actually I know very well what  types of apps I will develop for the pine phone.
as I mentioned I am very experienced desktop application developer.
I just don't know how developing for Linux mobile apps are is different from developing for desktop.
 
there must be some mobile application development kit (not android studio of course) that I need to use.
and that is why I posted this thread just to know what tools I need to develop for the PinePhone ??

[barray]

thank you for the replay barray but I think you got me wrong.

I think I did.

I am not asking for project suggestions. actually I know very well what  types of apps I will develop for the pine phone.
as I mentioned I am very experienced desktop application developer.
I just don't know how developing for Linux mobile apps are is different from developing for desktop.
 
there must be some mobile application development kit (not android studio of course) that I need to use.
and that is why I posted this thread just to know what tools I need to develop for the PinePhone ??

It's just a Linux kernel running X server/Wayland. In theory all Linux applications should run on the PinePhone, although some consideration needs to be given to the screen resolution/orientation (i.e. layout) and the processor speed (slow).

[ZX Spectrum]

thank you for the replay barray but I think you got me wrong.

I think I did.

I am not asking for project suggestions. actually I know very well what  types of apps I will develop for the pine phone.
as I mentioned I am very experienced desktop application developer.
I just don't know how developing for Linux mobile apps are is different from developing for desktop.
 
there must be some mobile application development kit (not android studio of course) that I need to use.
and that is why I posted this thread just to know what tools I need to develop for the PinePhone ??

It's just a Linux kernel running X server/Wayland. In theory all Linux applications should run on the PinePhone, although some consideration needs to be given to the screen resolution/orientation (i.e. layout) and the processor speed (slow).

so can I use good old eclipse ??
 how about the user interface design ?
shouldnt be  something equivalent to android studio ???

[kqlnut]

You can check out this guide for some tools and examples including UI and go on from there. But as already said, the PinePhone is just another Linux system (which makes it so great), no specific platform which would require unique tools.

[Cuperino]

I would like to know what tools, books I need to learn in order to start developing apps for the PinePhone Pro ?

Hello @ZX Spectrum,
There are four different frameworks you can use to develop mobile Linux apps:

1. KDE's Kirigami Framework
   
2. Gnome's libadwaita
   
3. KDE's MAUI Kit
   
4. Google's Flutter
   

Kirigami Framework
Kirigami is designed to enable you to develop app with convergent user interfaces, meaning you develop the GUI frontend once and your app automatically adjusts itself for mobile and desktop environments. Kirigami apps use QML for the frontend and C++ or, alternatively, Python for their backend.
Like all KDE software, Kirigami is built on top of the Qt 5 framework and will later transition to Qt 6. Qt development greatly focuses on embedded devices, making Qt the best performing framework for mobile Linux app development. Outside of KDE software, Kirigami is used by two third party apps: Subsurface and QPrompt. Disclaimer, I'm the developer behind QPrompt. I chose Kirigami and Qt for QPrompt precisely because a fast performing UI was an absolute requirement for my project.
Use the following resources to get started with Kirigami:

• Kirigami's Documentation https://api.kde.org/frameworks-api/frame.../index.htm
  
• Other KDE APIs https://api.kde.org/
  
• KDE's Human Interface Guidelines https://develop.kde.org/hig/
  
• Introductory talk about Kirigami https://www.qtdesktopdays.com/kirigami-c...rst-class/
  
• Qt's documentation on QML https://doc.qt.io/qt-5/qmlfirststeps.html
  
• KDAB's video tutorial series on Qt and QML: https://www.youtube.com/watch?v=JxyTkXLb...707dh9DPRc
  
• Bryan Carins tutorial series on Qt to learn more about Qt's backend https://www.youtube.com/watch?v=pHc7siV2...3&index=27
  

Some of those resources are meant for entry level developers. I leave them here for newcomers that come across this thread. I found them very useful.
Kirigami apps can run on Linux, Android, iOS, Windows, macOS, and other Unix systems. Nevertheless, Android support is minimal and iOS support is basically nonexistent.
KDevelop is a DE that tightly integrates with KDE libraries and frameworks such as Kirigami.

Libdwaita
If you like the simple and elegant designs of Gnome apps, libadwaita is a great option. Libadwaita is Gnome's new move towards convergent apps. It is the successor to the libhandy libraries, which were used to make regular Gnome apps work on mobile Linux environments. Libadwaita apps are built on top of the GTK 4 framework and are developed in C, and there are also bindings for other languages, such as Rust, JavaScript, and Python.
Many Gnome and Elementary OS apps are in the process of transitioning from GTK 3 to GTK 4 and from using libhandy to libadwaita. GTK 3 software is known to have terrible performance, even on hardware accelerated systems. This is why Posh, and mobile Gnome app will perform at a lower frame rate even on the PinePhone Pro. GTK 4 is much faster, nearing the performance of Qt apps on desktop. I have yet to see how effective this performance increase is for mobile applications.
Here are some resources to get started with libadwaita:

• libadwaita's Documentation https://gnome.pages.gitlab.gnome.org/libadwaita/doc/
  
• Gnome's Human Interface Guidelines https://developer.gnome.org/hig/
  
• Other Gnome libraries and API's https://developer.gnome.org/documentatio...nents.html
  

Libadwaita apps run on Linux, Windows, macOS, and other Unix systems.
Gnome Builder is a DE that tightly integrates with Gnome libraries and such as libawaita.

Maui Kit
Maui Kit is a UI kit developed by Nitrux as part of the KDE Project. It is built on top of Kirigami focused on building beautiful convergent applications. If offers more tools to create great UIs at the expense of slower startup times and slightly less performance. Maui Kit is not to be confused with Microsoft's MAUI Kit, which is a similar project that came after.

• Website https://mauikit.org/
  
• All of Kirigami's resources apply to Maui Kit as well
  
• I failed to find any documentation specific to Maui Kit. You'll probably have to study existing app's source code to develop with Maui.
  

Maui Kit apps can run anywhere where Kirigami apps run.
KDevelop is a DE that tightly integrates with KDE libraries and frameworks such as Maui Kit.

Flutter
Flutter is the GUI toolkit native to Fuchsia OS. It is a cross platform GUI framework designed for mobile apps, that has moved to enable development in the desktop as well. Apps developed in Flutter are written in the Dart programming language. Flutter's performance is comparable to Qt's, although it's in fact slower. Out of the aforementioned frameworks it is the one with least integration with mobile Linux environments. Nevertheless, Flutter apps that make use of a theme that simulates GTK 3 can feel native to a Linux environment. A Linux app developed with Flutter is AppImage Pool.
Flutter apps can run on Linux, Android, iOS, Windows and macOS. Out of all the aforementioned frameworks, it is the best option for cross platform mobile apps, as it tightly integrates with both Android and iOS. For desktop apps that also work on the phone, you should use one of the aforementioned frameworks. Flutter is also your only option for commercial apps where access to advertisement resources is necessary. Nevertheless, as you probably know, ads in apps are not well received in the Linux community.
Here are some resources to get started with Flutter:

• Flutter Documentation https://flutter.dev/learn
  
• Find third party libraries for your project https://pub.dev/
  

Flutter apps are native to mobile devices, and run on Android, iOS, Linux, Fuchsia, Windows, and macOS.

I prefer reading books over scavenging from badly written blogs and tutorials

Sorry. There are no books about most of these libraries. With the exception of Qt, GTK, and Kirigami, this is all pretty new. Qt's documentation is amazingly good, Flutter's seems great also. Most others help you understand the frameworks, but you'll have to study other people's open source code in order to make the most from them. This is especially true when it comes to porting your app from Linux to other platforms.

Distributing your app
The best and simplest way to make your app available on most mobile Linux distros is as a Flatpak package distributed through Flathub, because Flatpak support now comes by default in most distros, and Flathub compiles your program for arm64 as well as amd64 architectures.
https://github.com/flathub/flathub/wiki/App-Submission
Follow Gnome Software's guidelines for distribution to prepare your app for distribution, irregardless of the framework it was written in.
https://gitlab.gnome.org/GNOME/gnome-sof...e-metadata