Jump to content

Plasma/Active/Installation: Difference between revisions

From KDE Community Wiki
Sebas (talk | contribs)
note about declarative branch
Fahad (talk | contribs)
 
(218 intermediate revisions by 32 users not shown)
Line 1: Line 1:
= Installing Plasma Active =
= Plasma Active Images =


== Balsam Professional Live Image ==
The Plasma Active team provides official Images based on Mer for some devices.
[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 either install these on top of an already running openSUSE 11.4, or 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/plasma-active.i686-1.0.6.iso here].


== Installation on openSUSE ==
== Supported ==


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 post-4.6 development snapshot 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".
=== WeTab / ExoPC ===


Important: this procedure '''will upgrade your KDE installation''' to snapshots of various 4.7pre development branches, replacing any stable 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'''.
The hardware is a little outdated but you will get the most polished Plasma Active experience on this device.  


=== Installation Recipe ===
* [https://share.basyskom.com/plasma-active/deployment/wetab-exopc/tablet/mer/stable/basyskom-plasma-active-four-wetab-exopc-tablet-mer-release.iso Download ISO]
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
* [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]


solver.allowVendorChange = false
Take a look at the installation instructions [http://community.kde.org/Plasma/Active/WeTab here].


to
== Preview ==


solver.allowVendorChange = true
=== 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 [https://wiki.merproject.org/wiki/Community_Workspace/Tegra3/Nexus7/PA_installation Mer Wiki]


<!--
=== Archos G9 ===
To install Plasma Active, add tittiatcoke's  UNSTABLE_KDE4 repository and sebas' repo containing builds of the declarative branch from kdelibs and kde-runtime. As root:
<nowiki>
# Add titti's KDE unstable repo
zypper ar \
http://download.opensuse.org/repositories/home:/rwooninck:/UNSTABLE_KDE4/openSUSE_11.4/ \
  kde-unstable


# Now elevate its priority to it will override the existing packages
Take a look at [http://ruedigergad.com/2013/02/24/plasma-active-archos-g9-armv7hl-rootfs-tarballs/ Ruedigers Blog] for more information.
zypper mr -p 100 kde-unstable


# Add sebas' home repo containing Plasma Active
=== Nokia N950 ===
zypper ar \
http://download.opensuse.org/repositories/home:/vizzzion/kde-unstable/ \
plasma-active


# Elevate its priority to it will override even unstable packages
Take a look at [http://www.osnews.com/story/25307/Nokia_N950_Running_Plasma_Active_on_Mer this OSnews article] for more information.
zypper mr -p 101 plasma-active


# force cache update
=== VirtualBox ===
zypper refresh -f
</nowiki>


On to the installation of the actual packages. Again, as root, do:
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:
<nowiki>
* Performance, especially graphics, boot and application startup might be reduced
zypper in plasma-active:kdebase4-runtime plasma-tablet-config plasma-declarative-widgets
* 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
</nowiki>
* User interfaces designed for touch-screens often work less efficiently for mouse and keyboard based input methods, or feel less natural.
This will install the "plasma-mobile" packages, and a few others on your system, which is contained 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.
-->
<!-- use this version once we are ready to use KDE:Active repos -->
<!-- NB we could produce a pattern that allows activating this with one-click-install saving the zypper work, but that's like leaving a loaded gun within reach of children -->
<!--
=== Alternative Installation Recipe for openSUSE 11.4===
-->
Register KDE:Unstable:SC and KDE:Active repositories:
<nowiki>
zypper addrepo --refresh \
  http://download.opensuse.org/repositories/KDE:/Unstable:/SC/openSUSE_11.4 kusc
zypper addrepo --refresh \
  http://download.opensuse.org/repositories/KDE:/Active/openSUSE_11.4_KDE_Unstable_SC/ plasma-active
</nowiki>
Increase KDE:Active packages' priority relative to KDE:Unstable:SC, because the git snapshot versioning is otherwise lower than those in KDE:Unstable:SC, and we want the KDE:Active versions that are built with Active-specific options:
<nowiki>
zypper modifyrepo --priority 110 plasma-active
</nowiki>
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 --force plasma-active:kdebase4-runtime plasma-tablet-config plasma-declarative-widgets
</nowiki>


This will install the "plasma-mobile" packages, and a few others on your system, which is contained 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.


In order to make sure that plasma active works, check if the kdebase4-runtime package comes from the plasma-active repo, (zypper if kdebase4-runtime), if it doesn't:
For detailed installation instructions, see this [http://community.kde.org/Plasma/Active/VirtualBox installation manual].
<nowiki>
zypper in --force plasma-active:kdebase4-runtime
</nowiki>
(If this is not the case, the shell will complain about qtextracomponents not being found.)


=== Running Plasma Active ===
= Downstream Plasma Active =
From a full Plasma Desktop (or Netbook) user experience, you can switch 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
Some distributions provide Images with Plasma Active for x86 Systems.
plasma-tablet


# It is also possible to run Plasma Active in a window,
== Kubuntu Active ==
# this is useful for testing purposes:
plasma-tablet --nodesktop
</nowiki>


=== Installation of Plasma Active from sources ===
Current stable release of a Kubuntu remix with Plasma Active is available at


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.
http://cdimage.ubuntu.com/kubuntu-active/releases/13.04/release/
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:
Daily unstable images of a Kubuntu Active are 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/daily-live/
<nowiki>
git clone git://anongit.kde.org/plasma-mobile


cd plasma-mobile
You can burn image to CD (e.g. with k3b) or USB (e.g. with usb-creator-kde)


mkdir build
https://help.ubuntu.com/community/BurningIsoHowto#Kubuntu


cd build
It includes an installer '''ubiquity'''.


cmake .. -DCMAKE_INSTALL_PREFIX=/usr
== openSUSE ==


make
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!


sudo make install
It can be installed as follows:
</nowiki>


== MeeGo / ARM ==
zypper ar http://download.opensuse.org/repositories/KDE:/Active/openSUSE_Factory PA
A repository of most of KDE components, including Plasma Active for MeeGo is at
http://repo.pub.meego.com/home:/mkruisselbrink%3a/kde/meego_1.1_core/home%3amkruisselbrink%3akde.repo


i586 and ARM repositories available
zypper ref && zypper install plasma-mobile declarative-plasmoids  bodega-client


== Other Systems ==
If the Maliit onscreen keyboard is wanted, additionally install maliit-framework maliit-plugins maliit-inputcontext-qt4
If you have installed Plasma Active on a system not yet listed here, please add detailed installation instructions in a new section.
 
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 =
 
[http://community.kde.org/Plasma/Active/Info Suggestions, FAQ, additional information]

Latest revision as of 19:53, 16 June 2015

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