|
|
| (195 intermediate revisions by 27 users not shown) |
| Line 1: |
Line 1: |
| = Installing Plasma Active = | | = Plasma Active Images = |
|
| |
|
| == Live Images==
| | The Plasma Active team provides official Images based on Mer for some devices. |
|
| |
|
| === Balsam Professional === | | == Supported == |
| [http://open-slx.de open-slx] creates regularly updated packages of Balsam Professional for Plasma Active. These can be used as testing base and to track progress. You can try the Live ISO from a USB stick. Download the Balsam Professional live image, which is based on openSUSE [http://download.open-slx.com/iso/11.4/ here] (use the highest version numbered iso file).
| |
|
| |
|
| === MeeGo Plasma Contour === | | === WeTab / ExoPC === |
| [http://basyskom.com basysKom] creates regularly updated packages of Plasma Active based on MeeGo. These can be used as testing base and to track progress. You can try the installable Live ISO from a USB stick. Download the [http://share.basyskom.com/contour/Deployment/latest-meego-plasma-active-testing.html latest demo and testing live image].
| |
|
| |
|
| == Installation on openSUSE ==
| | The hardware is a little outdated but you will get the most polished Plasma Active experience on this device. |
|
| |
|
| In order to install the latest development snapshots on openSUSE 11.4, you have to add two repositories to your system. These update kdelibs and kde-runtime to a patched 4.7 which contains additions in QML bindings and improvements needed to run the development version for Plasma Active. If you would like to try it in a virtual machine, we recommend Virtualbox, which provides accelerated graphics capable of "desktop effects".
| | * [https://share.basyskom.com/plasma-active/deployment/wetab-exopc/tablet/mer/stable/basyskom-plasma-active-four-wetab-exopc-tablet-mer-release.iso Download ISO] |
| | * [https://share.basyskom.com/plasma-active/deployment/wetab-exopc/tablet/mer/stable/basyskom-plasma-active-four-wetab-exopc-tablet-mer-release-iso.sha1 Checksum] (sha1: 51bd1ac2aea097d8e17503a92ce2781a6532491d) |
| | * [https://share.basyskom.com/plasma-active/deployment/wetab-exopc/tablet/mer/stable/ Download Archive] |
|
| |
|
| Important: this procedure '''will upgrade your KDE installation''' to snapshots of 4.7, replacing any KDE packages you have installed. Some versions of these packages, for example kdepim4 and kdepim4-runtime, are built for a mobile target and the desktop versions of their apps '''will not run properly'''. Running a newer version of KDE may update users' configuration files in a way that is '''not backward-compatible with previous versions''' of the applications, so it is advised to use a development installation or backup your KDE configuration. If you don't know how to do this, '''stay with the Live image'''.
| | Take a look at the installation instructions [http://community.kde.org/Plasma/Active/WeTab here]. |
|
| |
|
| === Installation Recipe === | | == Preview == |
| ==== Preparation ====
| |
| As you are going to install packages from a different source, or so-called "vendor", you can make your life easier by telling zypper to automatically resolve packages across vendors. In /etc/zypp/zypp.conf, change the following line
| |
|
| |
|
| solver.allowVendorChange = false
| | === Nexus 7 === |
|
| |
|
| to
| | Even though very much already works reasonably well, there are still some glitches. So, please don’t expect a 100% working system. For detailed installation instructions, see the article on the [https://wiki.merproject.org/wiki/Community_Workspace/Tegra3/Nexus7/PA_installation Mer Wiki] |
|
| |
|
| solver.allowVendorChange = true
| | === Archos G9 === |
|
| |
|
| ==== Repository Setup ====
| | Take a look at [http://ruedigergad.com/2013/02/24/plasma-active-archos-g9-armv7hl-rootfs-tarballs/ Ruedigers Blog] for more information. |
| Register KDE:Unstable:SC and KDE:Active repositories:
| |
| <nowiki>
| |
| zypper addrepo --refresh \
| |
| http://download.opensuse.org/repositories/KDE:/Release:/47/openSUSE_11.4 kr47
| |
| zypper addrepo --refresh \
| |
| http://download.opensuse.org/repositories/KDE:/Active/openSUSE_11.4/ plasma-active
| |
| </nowiki>
| |
|
| |
|
| Increase KDE:Active packages' priority relative to KDE:Release:47, because the git snapshot versioning is otherwise lower than those in KDE:Release:47, and we want the KDE:Active versions that are built with Active-specific options:
| | === Nokia N950 === |
| <nowiki>
| |
| zypper modifyrepo --priority 90 plasma-active
| |
| </nowiki>
| |
|
| |
|
| ==== Package Installation ====
| | Take a look at [http://www.osnews.com/story/25307/Nokia_N950_Running_Plasma_Active_on_Mer this OSnews article] for more information. |
| Update all packages to the latest versions, trust the keys for the repos. NOTE: if you have other additional repositories than these registered in your system, YOU are responsible for making sure they are compatible.
| |
| <nowiki>
| |
| zypper dist-upgrade
| |
| </nowiki>
| |
| Finally, install the Plasma Active specific packages:
| |
| <nowiki>
| |
| zypper install plasma-contour-config </nowiki>
| |
|
| |
|
| This will install and setup the Plasma Active shell, which is contained in the plasma-mobile package (plasma-mobile has different sets of QML user interfaces per UI profile). zypper will ask you to accept the key. It will also suggests vendor changes for some packages. Accept these options.
| | === VirtualBox === |
|
| |
|
| === Running Plasma Active ===
| | When running Plasma Active in a virtual machine, consider that performance will not be as good as when it runs naively on the devices it has been designed for. For testing, we strongly recommend running Plasma Active on a device. The following limitations need consideration when using a virtual machine instead of a real device: |
| If you have installed the plasma-tablet-config package, your system will automatically start into Plasma Active. Just make sure you have autologin enabled in Yast and restart your system.
| | * Performance, especially graphics, boot and application startup might be reduced |
| | * Advanced visual effects might not be available or work correctly in the virtual machine. This can lead to degradation of certain features, performance, visual effects and possibly stability |
| | * User interfaces designed for touch-screens often work less efficiently for mouse and keyboard based input methods, or feel less natural. |
|
| |
|
| From a full Plasma Desktop (or Netbook) user experience, you can also switch at runtime to Plasma Active as follows (as user logged into the the X11 session):
| |
| <nowiki>
| |
| # Quit your plasma session
| |
| kquitapp plasma-desktop
| |
| or
| |
| kquitapp plasma-netbook
| |
|
| |
|
| # Start Plasma Active
| | For detailed installation instructions, see this [http://community.kde.org/Plasma/Active/VirtualBox installation manual]. |
| plasma-device
| |
|
| |
|
| # It is also possible to run Plasma Active in a window,
| | = Downstream Plasma Active = |
| # this is useful for testing purposes:
| |
| plasma-device --nodesktop
| |
| </nowiki>
| |
|
| |
|
| === Installation of Plasma Active from sources ===
| | Some distributions provide Images with Plasma Active for x86 Systems. |
|
| |
|
| While the recommended way to test Plasma Active is with the above recipe using the binary packages, it is possible to build Plasma Active from the source repository, who wants to try the bleeding edge repository can build plasma-mobile from sources.
| | == Kubuntu Active == |
| The recommended way is to follow the usual kde from sources [http://techbase.kde.org/Getting_Started build instructions]. It is also possible to use the binary kde packages as a base.
| |
|
| |
|
| It is necessary to install some packages (and their dependencies) to have a working development environment:
| | Current stable release of a Kubuntu remix with Plasma Active is available at |
| <nowiki>
| |
| sudo zypper install gcc gcc-c++ git cmake, kdelibs-devel
| |
| </nowiki>
| |
|
| |
|
| Now clone the plasma mobile source repository and build:
| | http://cdimage.ubuntu.com/kubuntu-active/releases/13.04/release/ |
| <nowiki>
| |
| git clone git://anongit.kde.org/plasma-mobile
| |
|
| |
|
| cd plasma-mobile
| | Daily unstable images of a Kubuntu Active are at |
|
| |
|
| mkdir build
| | http://cdimage.ubuntu.com/kubuntu-active/daily-live/ |
|
| |
|
| cd build
| | You can burn image to CD (e.g. with k3b) or USB (e.g. with usb-creator-kde) |
|
| |
|
| cmake .. -DCMAKE_INSTALL_PREFIX=/usr
| | https://help.ubuntu.com/community/BurningIsoHowto#Kubuntu |
|
| |
|
| make
| | It includes an installer '''ubiquity'''. |
|
| |
|
| sudo make install
| | == openSUSE == |
| </nowiki>
| |
|
| |
|
| === Installing Additional Software ===
| | PlasmaActive has been packaged for opensuse in the KDE:Active OBS Repository. |
| | Mind that it is ALPHA Quality. The apps that come with a Mer-based image might not be available and there may be bugs. Feel free to report (and fix) them or improve the packaging process. Help will be welcome! |
|
| |
|
| There are a few KDE projects that have created touch friendly versions of their applications already. These versions are included in the plasma-active repository. Currently, these are:
| | It can be installed as follows: |
|
| |
|
| * Calligra Active - Install package calligra-active
| | zypper ar http://download.opensuse.org/repositories/KDE:/Active/openSUSE_Factory PA |
| * Kontact Touch - Install package kontact
| |
|
| |
|
| In addition, some applications already work quite well together with active. The following is a list of applications that work ok on a touchscreen:
| | zypper ref && zypper install plasma-mobile declarative-plasmoids bodega-client |
|
| |
|
| * Okular - For viewing documents.
| | If the Maliit onscreen keyboard is wanted, additionally install maliit-framework maliit-plugins maliit-inputcontext-qt4 |
| * Marble - Virtual globe, includes routing support.
| |
| * Bangarang - Media player, uses Nepomuk for listing media.
| |
| * Dolphin - File manager.
| |
|
| |
|
| Some of these applications, like Bangarang, are not included in either the KDE:Release or plasma-active repositories. Instead, they can be installed from the KDE:Extra repository by adding it to zypper with the following command:
| | Only i586 has been tested. To run PA4 the preferred method is to create a .xinitrc file in the home directory and add a line saying 'startactive'. Then a call to 'startx' will bring it up. |
|
| |
|
| | There currently is an issue with plasma-desktop beeing started automatically so the file '/usr/share/autostart/plasma-desktop.desktop' needs to be (re)moved before running PlasmaActive. |
|
| |
|
| #Add KDE:Extra repository
| | There is also a LiveCD available at http://susestudio.com/a/GzMWEV/activesuse |
| zypper addrepo --refresh http://download.opensuse.org/repositories/KDE:/Extra/KDE_Release_47_openSUSE_11.4 kde-extra
| |
| #Install Bangarang
| |
| zypper install bangarang
| |
|
| |
|
| == MeeGo == | | = Get started after install = |
|
| |
|
| === Installation ===
| | [http://community.kde.org/Plasma/Active/Info Suggestions, FAQ, additional information] |
| | |
| A repository of most of KDE components, including Plasma Active for MeeGo is at https://build.pub.meego.com/project/show?project=Project%3AKDE%3ADevel and is available for both i586 and ARM, which is added by running the following command if you are using MeeGo trunk
| |
| | |
| zypper ar http://repo.pub.meego.com/Project:/KDE:/Devel/Trunk/Project:KDE:Devel.repo
| |
| | |
| or for MeeGo 1.2 users:
| |
|
| |
| zypper ar http://repo.pub.meego.com/Project:/KDE:/Devel/MeeGo_1.2_OSS/Project:KDE:Devel.repo
| |
| | |
| To install the software run the following command:
| |
| | |
| zypper install plasma-active
| |
| | |
| === UX Launch ===
| |
| | |
| uxlaunch is the MeeGo component that actually launches the shell. There are two ways of switching the default MeeGo Tablet UX shell to Plasma.
| |
| | |
| ==== Changing UX permanently ====
| |
| | |
| Edit /etc/sysconfig/uxlaunch and change the session key to "/usr/bin/startkde".
| |
| | |
| ==== Dynamic UX selection at boot ====
| |
| | |
| Finally, to switch to using the plasma tablet UX in MeeGo, use the uxselector project, following the instructions found here: http://wiki.meego.com/MeeGo_Desktop/Changing_Desktops#UXSelect_Switcher_Tool_.28alpha.29 - edit the /etc/xdg/aard/uxselect.conf file to include the following section:
| |
| | |
| <nowiki>
| |
| [plasma]
| |
| | |
| name=Plasma Active
| |
| | |
| description=The Plasma Active Tablet UX
| |
| | |
| path=/usr/bin/startkde
| |
| </nowiki>
| |
| | |
| and add the text plasma text to the uxlist property in the General section.
| |
| | |
| ==== Known Issues ====
| |
| | |
| The Meego tablet UX installs a number of files in /etc/xdg/autostart that are also executed when running Plasma Active, resulting in elements of the Meego tablet UX showing up nevertheless. Workaround is to rename/remove that folder.
| |
| | |
| === MeeGo system image===
| |
| a complete ready to go image of Plasma Active with the Contour UX is provided at the [http://share.basyskom.com/contour/Deployment/ basysKom image repository]
| |
| | |
| == Other Systems ==
| |
| If you have installed Plasma Active on a system not yet listed here, please add detailed installation instructions in a new section.
| |
Plasma Active Images
The Plasma Active team provides official Images based on Mer for some devices.
Supported
WeTab / ExoPC
The hardware is a little outdated but you will get the most polished Plasma Active experience on this device.
Take a look at the installation instructions here.
Preview
Nexus 7
Even though very much already works reasonably well, there are still some glitches. So, please don’t expect a 100% working system. For detailed installation instructions, see the article on the Mer Wiki
Archos G9
Take a look at Ruedigers Blog for more information.
Nokia N950
Take a look at this OSnews article for more information.
VirtualBox
When running Plasma Active in a virtual machine, consider that performance will not be as good as when it runs naively on the devices it has been designed for. For testing, we strongly recommend running Plasma Active on a device. The following limitations need consideration when using a virtual machine instead of a real device:
- Performance, especially graphics, boot and application startup might be reduced
- Advanced visual effects might not be available or work correctly in the virtual machine. This can lead to degradation of certain features, performance, visual effects and possibly stability
- User interfaces designed for touch-screens often work less efficiently for mouse and keyboard based input methods, or feel less natural.
For detailed installation instructions, see this installation manual.
Downstream Plasma Active
Some distributions provide Images with Plasma Active for x86 Systems.
Kubuntu Active
Current stable release of a Kubuntu remix with Plasma Active is available at
http://cdimage.ubuntu.com/kubuntu-active/releases/13.04/release/
Daily unstable images of a Kubuntu Active are at
http://cdimage.ubuntu.com/kubuntu-active/daily-live/
You can burn image to CD (e.g. with k3b) or USB (e.g. with usb-creator-kde)
https://help.ubuntu.com/community/BurningIsoHowto#Kubuntu
It includes an installer ubiquity.
openSUSE
PlasmaActive has been packaged for opensuse in the KDE:Active OBS Repository.
Mind that it is ALPHA Quality. The apps that come with a Mer-based image might not be available and there may be bugs. Feel free to report (and fix) them or improve the packaging process. Help will be welcome!
It can be installed as follows:
zypper ar http://download.opensuse.org/repositories/KDE:/Active/openSUSE_Factory PA
zypper ref && zypper install plasma-mobile declarative-plasmoids bodega-client
If the Maliit onscreen keyboard is wanted, additionally install maliit-framework maliit-plugins maliit-inputcontext-qt4
Only i586 has been tested. To run PA4 the preferred method is to create a .xinitrc file in the home directory and add a line saying 'startactive'. Then a call to 'startx' will bring it up.
There currently is an issue with plasma-desktop beeing started automatically so the file '/usr/share/autostart/plasma-desktop.desktop' needs to be (re)moved before running PlasmaActive.
There is also a LiveCD available at http://susestudio.com/a/GzMWEV/activesuse
Get started after install
Suggestions, FAQ, additional information
