Maliit/Installing

Revision as of 15:16, 10 June 2011

Installing

Meego

Meego Input Methods comes preinstalled on:

• Meego Handset UX 1.1 and later
• Meego Tablet UX 1.2 and later

Meego Netbook UX

These steps have been tested on Meego 1.1.

• Enable the 'handset' repository. For example:

$ sudo zypper addrepo http://repo.meego.com/MeeGo/releases/1.1/handset/repos/ia32/packages/ handset
$ sudo zypper refresh

• Install these packages:
  • meegotouch-inputmethodbridges
  • meegotouch-inputmethodkeyboard

sudo zypper install meegotouch-inputmethodkeyboard meegotouch-inputmethodbridges 

• Modify /etc/xdg/autostart/meego-im-uiserver.desktop to look like this:

[Desktop Entry]
Exec=/usr/bin/meego-im-uiserver -target slate -bypass-wm-hint
X-Moblin-Priority=High
OnlyShowIn=X-MEEGO-HS;X-MEEGO-NB

This will work with 1024x600 resolution. Replace 'slate' with other code if you have different resolution. See /etc/meegotouch/devices.conf for different codes.

• Add this line to ~/.bashrc (any better place in X configs? /etc/X11/xinitrc-common failed for me) to activate the inputmethod plugin for Qt-based programs:

export QT_IM_MODULE=MInputContext

• Relogin (or reboot) to desktop

Ubuntu (10.04 Lucid Lynx / 10.10 Maveric Meerkat)

The MeeGo Input Methods are not yet in any official Ubuntu repository. However, the packages are available through Launchpad. They are provided to ease development of input method plugins, without the need of using the MeeGo SDK or even scratchbox.

To install the packages, you will need to add two Launchpad PPA's to your system's software sources:

• Under System → Administration → Software Sources, select "Other Software" or
  • Alternatively you can run Synaptics Package Manager and choose the menu Setting --> Package Sources where you can add the following PPA's in the tab "Other Software"
• Add ppa:openismus-team/openismus-meego-im
• Add ppa:kubuntu-ppa/backports (needed for Qt 4.7, on Lucid/Meerkat)
• Install meego-keyboard-dev and meegotouch-demos-widgetsgallery (for simple testing) through Synaptics Package Manager or
  • using this command line command(make sure that Synaptics is closed already):

sudo apt-get update && sudo apt-get install meego-keyboard-dev meegotouch-demos-widgetsgallery

Debian, and Ubuntu derivatives

You might be able to use the packages above. Let us know to which extend you succeed with this.

Fedora

For Fedora there are no Maliit packages available in the Fedora repository. But there are packages built with the Open Build Service (OBS). To install them:

• Download .repo file and save it as /etc/yum.repos.d/maliit.repo.
• Install the packages meego-inputmethodkeyboard and meego-inputmethodbridges with the Add/Remove Software application

For testing Maliit:

• As user start meego-im-uiserver in a terminal
• Run GTK_IM_MODULE=meego-im gedit

openSUSE 11.4 & Factory

The work-in-progress can be found at

http://download.opensuse.org/repositories/home:/janarnepetersen/openSUSE_11.4/

http://download.opensuse.org/repositories/home:/janarnepetersen/openSUSE_Factory/

Arch Linux

Preliminary git packages are available in AUR

To install framework, keyboard, Qt and Gtk+ support:

yaourt -S meegotouch-inputmethodkeyboard meegotouch-inputmethodbridges

Substitute yaourt with your favorite AUR helper.

Maemo 5 (Fremantle)

Warning: This is a rough tech demo and as such, fairly useless. Also, don't activate Maemo's extras-devel repo unless you exactly know what you are doing - it can brick your device!

• Install meego-keyboard-quick (needs extras-devel),
• Install meego-im-demos
• Open a terminal, start the MeeGo Input Methods service:

 $ meego-im-uiserver -bypass-wm-hint -software -graphicssystem raster

• Open a second terminal, to run the meego-im-demos-plainqt application:

 $ export QT_IM_MODULE=MInputContext
 $ meego-im-demo-plainqt -fullscreen -software -graphicssystem raster

Instead of the test application, one should be able to use it in any other Qt application, as long as the MeeGo Input Methods service is running and the QT_IM_MODULE environment variable is set correctly.

Other GNU/Linux

Grab the source source code from the git repositories above.

Meego Input Methods uses the qmake build system. So, to do a standard build and install, do:

qmake
make
make install

Dependencies

• All components have a hard dependency on Qt 4.7.
• Framework uses libmeegotouch by default. Pass CONFIG+=nomeegotouch to qmake to disable.
• Framework will build a setting applet for meegotouch-controlpanel by default. Pass CONFIG+=noduicontrolpanel to qmake to disable.
• Keyboard uses meego feedback framework (with reactionmaps) by default. Pass CONFIG+=noreactionmaps to qmake to disable.
• Keyboard currently has a hard dependency on libmeegotouch.

Work is ongoing to reduce the amount of dependencies in the different components.

Using

To quickly test your installation, it is recommended to use the widgetsgallery:

1. Make sure you have a compositing window manager running: Go to System → Appearance, select "Visual Effects" and choose either normal or extra.
2. Start the meego-im-uiserver (responsible for handling input method plugins and communication with the application) using a shell:

 meego-im-uiserver -software -bypass-wm-hint

1. Test virtual keyboard in MeeGo Touch's widgetsgallery (in a seperate shell):

 QT_IM_MODULE=MInputContext widgetsgallery

To integrate it with your system or product, use the distro-recommended way to start above daemon and setting the environment variable for all applications.

Debugging tips

1. Verify that the correct environment variables are set to load the correct input context (see above).
2. Run meego-im-uiserver with the "-output-level debug" flag (in addition to any other existing flags).
3. If problems with QT-based application, set the MIC_ENABLE_DEBUG=true. This will make the inputcontext output debug information.
4. If problems with GTK+ applications, recompile meegotouch-inputmethodbridges with the --enable-debug flag. This will make the inputcontext output debug information.