MeeCoLay

(initial page)
m (Extra)
 
(16 intermediate revisions not shown)
Line 5: Line 5:
== Configuration ==
== Configuration ==
-
This requires a bit more preparation than preenv. Why?
+
The first configuration should be in your mind ;)
-
MeeGo libraries are sometimes very hard to be built under Fremantle autobuilder. I was playing around a bit with applauncherd. It has insane dependencies, a lot of nokia-binaries, some packages that are too old in fremantle.
+
DO NOT RUN MEEGO APPS AS ROOT. This may cause them to crash.
-
It came out that using a precompiled libstdc++6 4.6.1 that can be found in a TMO thread and precompiled MeeGo binaries you can run many MeeGo apps (e.g. allegro, SzybkiDemot, ebay bargains - the first two are Polish apps)
+
=== First preparations ===
-
As compiling all the stuff requires lots of (often unneeded packages), I decided I'll upload the libs onto my server and they'll be in the end downloaded automatically.
+
First of all you need to have an updated packages list and extras-devel repository enabled, as meecolay always having new updates, new dependencies, new libraries packs.
-
=== First preparations ===
+
Each command should be run as root. You can obtain root shell by
 +
 
 +
sudo gainroot
 +
 
 +
Beware of root shell, as using it wrong you may brick your N900.
 +
 
 +
Update your package list using application manager via "update" button or using terminal
 +
apt-get update
 +
 
 +
Now you are ready to install meecolay !
 +
apt-get install meecolay
 +
Will install almost everything needed.
 +
Meecolay ships with its own included repo if you haven't manually installed newer version of glib2.0-0 or sqlite3, you may want to download them with
 +
apt-get install libglib2.0-0 sqlite3 libsqlite3-0
 +
Even if you don't install those packages, they should be automatically installed when they're needed when you try to correct dependencies
 +
apt-get install -f
 +
Note: that if the package gets uninstalled after this command, you need to modify its DEBIAN/control. Uninstall it, otherwise you won't be able to install anything else !. Modify the depends and install again. This should be eased up in the future.
 +
Now you are ready to try MeeGo games and apps using this command
 +
meecolay /path/to/executable
 +
 
 +
== Compatibility ==
 +
{{main|MeeCoLay/Compatibility}}
 +
The [[MeeCoLay/Compatibility|compatibility page]] lists programs that could be successfully executed and worked, reported by users. It also lists programs that partially work and also incompatible (yet?) programs.
 +
 
 +
== Workarounds ==
 +
{{main|MeeCoLay/Workarounds}}
 +
The [[MeeCoLay/Workarounds|workarounds page]] lists some common errors you might encounter while running an app through MeeCoLay, and how you can fix those errors.
 +
 
 +
== Bugs and Discussion ==
 +
Discuss MeeCoLay in [http://talk.maemo.org/showthread.php?t=84482 this talk.maemo.org thread].
 +
 
 +
Missing libraries and bugs should be reported in bugtracker: https://bugs.maemo.org/enter_bug.cgi?product=MeeCoLay
 +
 
 +
== Extra ==
 +
Would you like to have a GUI for MeeCoLay?
 +
It will:
 +
 
 +
*make installing Harmattan applications on Fremantle (N900) much easier and more user-friendly.
 +
 
 +
*move the icons and the desktop file to the right directory, so that you can launch it from the menu straight after installation.
 +
 
 +
*contain a function to add custom commands in the desktop file for running the applications.
 +
 
 +
*fetch any other changes than need to be done for flawless installation under Fremantle
 +
 
 +
*ask you how you want the apps to be installed - whether automatically with HAM (Hildon Application Manager) or manually (e.g. with dpkg)
 +
 
 +
*add to the menu entries a fix for forced rotation: you won't have to lock the rotation manually anymore!
 +
 
 +
*be a graphically-rich Qt/QML user interface
-
First of all you need to download the libraries.
+
*include command-line tools, hopefully :)
-
Libraries can be downloaded from http://marmistrz.net63.net/meecolay/data
+
Do you like the idea? If yes, please consider giving more motivation to the MeeCoLay developer (marmistrz) and donating.
-
Adf.ly link: http://adf.ly/91YV1
+
-
The libraries have been downloaded from http://harmattan-dev.nokia.com/pool
+
You may as well pledge the donation, and pay after the development of the user interface has finished.
-
If you don't trust these libraries: just don't use 'em. You can download the same stuff from the mentioned harmattan repository.
+
-
Adf.ly link: http://adf.ly/91ZeN
+
-
They are tar.bz2-ed, just unpack it with
+
Donation link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=WUAUBSU3QQLNL
-
Code:
+
-
tar -xvf /path/to/file -C /opt/meecolay
+
-
Early builds of the downloader will be available as soon as it will seem usable, I'll push them onto my repository. As soon the downoader has all basic functions, it'll be pushed to extras-devel.
+
-
/opt/meecolay's owner should be user.
+
The more donations are received/pledged, the faster the GUI will be created!

Latest revision as of 08:45, 4 November 2012

Contents

[edit] What is MeeCoLay?

MeeCoLay stands for MeeGo Compatibility Layer. It allows to run Harmattan apps on Fremantle.

[edit] Configuration

The first configuration should be in your mind ;)

DO NOT RUN MEEGO APPS AS ROOT. This may cause them to crash.

[edit] First preparations

First of all you need to have an updated packages list and extras-devel repository enabled, as meecolay always having new updates, new dependencies, new libraries packs.

Each command should be run as root. You can obtain root shell by

sudo gainroot

Beware of root shell, as using it wrong you may brick your N900.

Update your package list using application manager via "update" button or using terminal

apt-get update

Now you are ready to install meecolay !

apt-get install meecolay

Will install almost everything needed. Meecolay ships with its own included repo if you haven't manually installed newer version of glib2.0-0 or sqlite3, you may want to download them with

apt-get install libglib2.0-0 sqlite3 libsqlite3-0

Even if you don't install those packages, they should be automatically installed when they're needed when you try to correct dependencies

apt-get install -f

Note: that if the package gets uninstalled after this command, you need to modify its DEBIAN/control. Uninstall it, otherwise you won't be able to install anything else !. Modify the depends and install again. This should be eased up in the future. Now you are ready to try MeeGo games and apps using this command

meecolay /path/to/executable

[edit] Compatibility

Main article: MeeCoLay/Compatibility

The compatibility page lists programs that could be successfully executed and worked, reported by users. It also lists programs that partially work and also incompatible (yet?) programs.

[edit] Workarounds

Main article: MeeCoLay/Workarounds

The workarounds page lists some common errors you might encounter while running an app through MeeCoLay, and how you can fix those errors.

[edit] Bugs and Discussion

Discuss MeeCoLay in this talk.maemo.org thread.

Missing libraries and bugs should be reported in bugtracker: https://bugs.maemo.org/enter_bug.cgi?product=MeeCoLay

[edit] Extra

Would you like to have a GUI for MeeCoLay? It will:

  • make installing Harmattan applications on Fremantle (N900) much easier and more user-friendly.
  • move the icons and the desktop file to the right directory, so that you can launch it from the menu straight after installation.
  • contain a function to add custom commands in the desktop file for running the applications.
  • fetch any other changes than need to be done for flawless installation under Fremantle
  • ask you how you want the apps to be installed - whether automatically with HAM (Hildon Application Manager) or manually (e.g. with dpkg)
  • add to the menu entries a fix for forced rotation: you won't have to lock the rotation manually anymore!
  • be a graphically-rich Qt/QML user interface
  • include command-line tools, hopefully :)

Do you like the idea? If yes, please consider giving more motivation to the MeeCoLay developer (marmistrz) and donating.

You may as well pledge the donation, and pay after the development of the user interface has finished.

Donation link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=WUAUBSU3QQLNL

The more donations are received/pledged, the faster the GUI will be created!