Plasma/Mobile/DevGuide: Difference between revisions
(Initial draft) |
(Added postmarketos option) |
||
| Line 18: | Line 18: | ||
{{Input|1=<nowiki> | {{Input|1=<nowiki> | ||
sudo apt install qemu-utils qemu-system-x86</nowiki>}} | sudo apt install qemu-utils qemu-system-x86</nowiki>}} | ||
== Mobile device running plasma mobile == | |||
Currently there are two possible ways of testing Plasma Mobile on an actual mobile device, | |||
* Using postmarketOS | |||
* Installing Halium and a KDE neon-based rootfs | |||
=== Using postmarketOS === | |||
PostmarketOS is touch-optimized, pre-configured Alpine Linux-based distribution which offers Plasma Mobile as one choice of several available user interfaces. There is a list of [https://wiki.postmarketos.org/wiki/Devices devices] that can run postmarketOS, and you can find [https://wiki.postmarketos.org/wiki/Installation_guide instructions] on installing postmarketOS on your device at their wiki page. | |||
When you follow the instructions to install postmarketOS, remember to select “plasma-mobile” as the user interface when asked: | |||
{{Input|1=<nowiki> | |||
Available user interfaces (5): | |||
* none: No graphical environment | |||
* hildon: (X11) Lightweight GTK+2 UI (optimized for single-touch touchscreens) | |||
* luna: (Wayland) webOS UI, ported from the LuneOS project (Not working yet) | |||
* plasma-mobile: (Wayland) Mobile variant of KDE Plasma, optimized for touchscreen | |||
* weston: (Wayland) Reference compositor (demo, not a phone interface) | |||
* xfce4: (X11) Lightweight GTK+2 desktop (stylus recommended) | |||
User interface [weston]: plasma-mobile | |||
</nowiki>}} | |||
Revision as of 17:03, 19 May 2018
Plasma Mobile Developer Guide
| Under Construction |
|---|
| This is a new page, currently under construction! |
The development environment needed depends on the area of Plasma Mobile development you want to contribute. There are three kinds of development environment:
- General KDE development environment
- Plasma Mobile emulated environment
- Mobile device running plasma mobile
Nevertheless, in case that you don't need an actual mobile device running Plasma Mobile, we strongly suggest to use a Plasma Mobile emulated environment, since such an environment will facilitate the testing of your work.
Plasma Mobile emulated environment
Get the Plasma Moible precompiled image
At first, you have to download the precompiled ISO image. TODO: Add link
Run the virtual machine
To use the precompiled ISO, QEMU should be installed. QEMU is a free and open-source hosted hypervisor that performs hardware virtualization. In KDE neon, just execute:
sudo apt install qemu-utils qemu-system-x86
Mobile device running plasma mobile
Currently there are two possible ways of testing Plasma Mobile on an actual mobile device,
- Using postmarketOS
- Installing Halium and a KDE neon-based rootfs
Using postmarketOS
PostmarketOS is touch-optimized, pre-configured Alpine Linux-based distribution which offers Plasma Mobile as one choice of several available user interfaces. There is a list of devices that can run postmarketOS, and you can find instructions on installing postmarketOS on your device at their wiki page.
When you follow the instructions to install postmarketOS, remember to select “plasma-mobile” as the user interface when asked:
Available user interfaces (5): * none: No graphical environment * hildon: (X11) Lightweight GTK+2 UI (optimized for single-touch touchscreens) * luna: (Wayland) webOS UI, ported from the LuneOS project (Not working yet) * plasma-mobile: (Wayland) Mobile variant of KDE Plasma, optimized for touchscreen * weston: (Wayland) Reference compositor (demo, not a phone interface) * xfce4: (X11) Lightweight GTK+2 desktop (stylus recommended) User interface [weston]: plasma-mobile