MeeCoLay

(First preparations)
m (Extra)
 
(13 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)
+
-
 
+
-
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 preparations ===
=== 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.
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
Update your package list using application manager via "update" button or using terminal
Line 21: Line 23:
Now you are ready to install meecolay !  
Now you are ready to install meecolay !  
-
  apt-get install meecolay*
+
  apt-get install meecolay
-
Will install meecolay, meecolay-core, libraries packs and the package dependencies.
+
Will install almost everything needed.
-
Now you should have
+
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
-
/opt/meecolay/
+
  apt-get install libglib2.0-0 sqlite3 libsqlite3-0
-
and please check
+
Even if you don't install those packages, they should be automatically installed when they're needed when you try to correct dependencies
-
/opt/meecolay/libs/
+
  apt-get install -f
-
if that directory does not contain libraries that means something goes wrong during installation so you need to reinstall them or download and installing the debians manually.
+
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.
-
All fine ? now you also need to update your Glib, after meecolay installation the package developer repository is automatically added to your repositories list ! http://marmistrz.net63.net/meecolay/.
+
-
Issue this command to update your Glib.
+
-
  apt-get install libglib2.0-0=2.22*
+
-
And
+
-
  /opt/meecolay's owner should be user.
+
-
 
+
Now you are ready to try MeeGo games and apps using this command
Now you are ready to try MeeGo games and apps using this command
-
  meecolay /path/to/executable  
+
  meecolay /path/to/executable
-
If you found some bugs during your tries please report them to the package bugtracker https://bugs.maemo.org/enter_bug.cgi?product=MeeCoLay.
+
 
-
And if you have some missing libraries when trying to run meecolay please tell that in meecolay thread http://talk.maemo.org/showthread.php?t=84482.
+
== 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
 +
 
 +
*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!

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!