QtComponents/Butaca
Butaca is an application to fetch movie-related information. You could see a more detailed description at its home page.
Contents |
Fetch sources
Get master code from git repository located at butaca repo
Remove unsupported libraries
Check control file to see deps of this apps. At first shight, it dependends of applauncherd and ShareUI. Right now, theres no replacement for this on Fremantle, so functionality provided should be removed.
Applauncherd
Provides a boost at instantiation time for apps that link with it. You could see more info at Harmmatan API Docs Besides that, provides invoker a tool to launch programs and add splashscreen while application is starting.
We are going to loose splash screen
To remove this library, lookup for MDeclarativeCache inside code. Once again grep is your friend. Once located, replace it by standard QApplication and QDeclarativeView classes.
<syntaxhighlight lang="diff"> diff --git a/src/main.cpp b/src/main.cpp index f27f608..8f1c989 100644 --- a/src/main.cpp +++ b/src/main.cpp @@ -22,24 +22,21 @@
#include <QtGui/QApplication> #include <QtDeclarative> #include <QDeclarativeContext>
-#include <MDeclarativeCache>
Q_DECL_EXPORT int main(int argc, char *argv[])
{
- QApplication *app = MDeclarativeCache::qApplication(argc, argv); - QDeclarativeView *view = MDeclarativeCache::qDeclarativeView(); + QApplication app = QApplication(argc, argv); + QDeclarativeView view = QDeclarativeView();
- QDeclarativeContext *context = view->rootContext(); + QDeclarativeContext *context = view.rootContext();
ButacaController *controller = new ButacaController(context);
- view->setSource(QUrl("qrc:/qml/main.qml")); - view->showFullScreen(); + view.setSource(QUrl("qrc:/qml/main.qml")); + view.showFullScreen();
int result = app->exec();
delete controller;
- delete view; - delete app;
return result; }
</syntaxhighlight>
Remove boostable deps from project files.
<syntaxhighlight lang=diff> diff --git a/butaca.pro b/butaca.pro index 465a010..a493faf 100644 --- a/butaca.pro +++ b/butaca.pro @@ -55,14 +55,8 @@ OTHER_FILES += \
RESOURCES += \
res.qrc
-# enable booster -CONFIG += qt-boostable qdeclarative-boostable \ - shareuiinterface-maemo-meegotouch \ +CONFIG += shareuiinterface-maemo-meegotouch \
mdatauri
-QMAKE_CXXFLAGS += -fPIC -fvisibility=hidden -fvisibility-inlines-hidden -QMAKE_LFLAGS += -pie -rdynamic - -LIBS += -lmdeclarativecache
butacascript.files = butaca butacascript.path = /usr/bin/
</syntaxhighlight>
And invoker from desktop file
<syntaxhighlight lang="diff"> diff --git a/butaca.desktop b/butaca.desktop index 4623ef8..d0af6f4 100644 --- a/butaca.desktop +++ b/butaca.desktop @@ -3,6 +3,6 @@ Encoding=UTF-8
Version=1.0 Type=Application Name=Butaca
-Exec=/usr/bin/invoker --single-instance --splash /usr/share/butaca/butaca-splash.jpg --type=d /usr/bin/butaca +Exec=/usr/bin/butaca
Icon=/usr/share/icons/hicolor/64x64/apps/butaca.png Categories=Network;
</syntaxhighlight>
commit
ShareUI
Share UI is a set of libraries and executables that implements platform-wide selection of destinations to share content. See project README for details.
Right now, we are going to support for this library (By the way, it seems portable to maemo5 without LMT. Any volunteers ?). Butacas defines a ButacaController class to share user preferences with others. So, we follow a 2 step approach
Hide ShareUI from C++ Code
Easy. we Just use Q_WS_MAEMO_5 and Q_WS_SIMULATOR to get this code compilable on Maemo5 and QtSimulator.
<syntaxhighlight lang="diff"> diff --git a/src/butacacontroller.cpp b/src/butacacontroller.cpp index edba60a..ea58198 100644 --- a/src/butacacontroller.cpp +++ b/src/butacacontroller.cpp @@ -4,8 +4,11 @@
#include "sortfiltermodel.h" #include <QDeclarativeContext>
+ +#if !defined(Q_WS_MAEMO_5) && !defined(Q_WS_SIMULATOR)
#include <maemo-meegotouch-interfaces/shareuiinterface.h>
-#include <MDataUri> +# include <MDataUri> +#endif
ButacaController::ButacaController(QDeclarativeContext *context) :
QObject(),
@@ -36,6 +39,7 @@ ButacaController::~ButacaController()
void ButacaController::share(QString title, QString url)
{
+#if !defined(Q_WS_MAEMO_5) && !defined(Q_WS_SIMULATOR)
// See https://meego.gitorious.org/meego-sharing-framework/share-ui/blobs/master/examples/link-share/page.cpp // and http://forum.meego.com/showthread.php?t=3768 MDataUri dataUri;
@@ -52,6 +56,10 @@ void ButacaController::share(QString title, QString url)
} else {
qCritical() << "Invalid interface";
}
+#else + Q_UNUSED(title); + Q_UNUSED(url); +#endif
} void ButacaController::fetchTheaters(QString location)
</syntaxhighlight>
And disable config requirements on butaca.pro
<syntaxhighlight lang="diff"> diff --git a/butaca.pro b/butaca.pro index a493faf..268b85a 100644 --- a/butaca.pro +++ b/butaca.pro @@ -55,8 +55,10 @@ OTHER_FILES += \
RESOURCES += \
res.qrc
+!maemo5:!simulator {
CONFIG += shareuiinterface-maemo-meegotouch \
mdatauri
+}
</syntaxhighlight>
Disable functionality on QML land
Disable share button on butaca toolbar
<syntaxhighlight lang="diff"> diff --git a/qml/ButacaToolBar.qml b/qml/ButacaToolBar.qml index a57bbcb..a7d2ebe 100644 --- a/qml/ButacaToolBar.qml +++ b/qml/ButacaToolBar.qml @@ -83,7 +83,7 @@ ToolBarLayout {
when: content !== undefined
PropertyChanges {
target: shareIcon
- enabled: true + enabled: false
visible: true
}
PropertyChanges {
</syntaxhighlight>
commit
Refactor QML files
As on [QtComponents/Miniature], we need to replace namespace by the fremantle one. In this case we need to go a bit further.
Update namespace
Use [QtComponents/migrateTo], sed or an app like regexxer. See [QtComponents/Miniature] for required changes
Hardcoded Paths
Butaca fetch Properties directly from UIConstants.js js library. This library is private to QtComponents, so it uses a file://point/to/uiConstants.js schemas that we should also change.
See QtComponents/ThemeHowto for a better (and non upstream portable) way of doing this.
Remove QtQuick 1.1 code
Reached this point. Project should be runnable on QtSimulator. Use QtSimulator 1.1. If we get console.log errors, it would be produced by unsupported QtQuick 1.1 code.
<syntaxhighlight lang="bash"> PATH/TO/QTSIMULATOR 1.1/Qt/gcc/bin/qmake butaca.pro && make && ./butaca </syntaxhighlight>
See QtComponents/QtSimulator for hints about how to get QtComponents running on it
After a trial and error process we get: <syntaxhighlight lang="diff"> diff --git a/qml/MultipleMoviesDelegate.qml b/qml/MultipleMoviesDelegate.qml index 03b5a05..df468de 100644 --- a/qml/MultipleMoviesDelegate.qml +++ b/qml/MultipleMoviesDelegate.qml @@ -107,7 +107,9 @@ Item {
font.weight: movieDelegate.titleWeight
font.pixelSize: movieDelegate.titleSize
color: movieDelegate.titleColor
- maximumLineCount: 3 + //{QTQUICK1.1 + //maximumLineCount: 3 + //}
wrapMode: Text.WordWrap
text: title
}
</syntaxhighlight>
commit.
Handle Close events
This is easy in this case.
<syntaxhighlight lang="diff"> </syntaxhighlight>
commit
Adapt deployment to Fremantle
Some changes on how Butaca is deployed are needed to match Fremantle requirements.
Optify code
Update Desktop file
And finally, update desktop file. There's no applauncerd on fremantle, so remove invoker from Exec. With this action we loose splash-screen.
commit
Update packing scripts
Now that all required changes are commited. generate patches with <syntaxhighlight lang="bash">git format-patch origin/master</syntaxhighlight> and copy generated files into debian/patches directory.
Finally, modify rules file at debian directory to merge patches. At config-stamp rule add: <syntaxhighlight lang="make">for p in debian/patches/*; do patch -p1 < $$p; done </syntaxhighlight>
And thats all. You have Butaca working on Maemo5