N9のカレンダーフィード：概要と開発方法

この投稿は、「 Smart Posts for Smart Posts 」というコンテストに参加しています。



Nokia N9は、多くの点で優れたデバイスです。 しかし、箱から出してすぐには、非常に重要な機能はありません。 携帯電話のホーム画面を一目見ただけでは、先のカレンダーでどんなイベントが待っているのかを理解することは不可能です。 この厄介な問題を解決するために、私はCalendar Feedアプリケーション（ OVI Store 、 source ）を開発しました。 カットの下で、アプリケーション自体（少し）とそれがどのように作成されたか（投稿の大部分）について詳しく説明します。



注意、テキストがたくさんあります。 準備ができたら...



カレンダーフィードアプリケーション。 これはOSに完全に統合されており、ユーザーではなくOSを介して再度呼び出されます（ただし、ユーザーは[更新]ボタンを使用してアプリケーションデータの更新を急ぐことができます）。 設定はシステムに完全に統合され、その一部のように見えます。 動作中、アプリケーションは定期的に（20分ごと）、古いカレンダーを削除しながら、カレンダーから最も近いイベントを持つ要素をフィード（ロシア語版ではチャンネル）にアップロードします。 この要素は常に一番上にあります（その時刻は現在のプラス1日として設定されます）。 アプリケーションにはいくつかの設定がありますが（まだ非常に若く、少しだけ実行できます）、基本的な機能のすべての機能には十分です。 要素内のイベントの数を設定して、今日のイベントを将来（今日があまりない場合）に追加するかしないか、将来のイベントの日数に制限（切断の可能性がある場合）を設定できます（翌年または月のイベントを表示しないように）。

スクリーンショット





さて、これはすべて歌詞であり、このアプリケーションの実際の開発ほど興味深いものではありません。 最終的に、Habrは技術リソースです。 それでは、これらすべてがどのように詳細に開発されたかを理解しましょう。



次のポイントがソートされます。

• イベントを表示する
  
  - クラスMEventFeed
  
  -DBus
  
  -DB署名をHarmattanの腸に保存する機能
• Syncfw
  
  - メタデータ
  
  - 共有ライブラリ
  
  -SyncFWプラグインのローカライズ
  
  - 更新ボタンで更新
• カスタマイズ用アプレット
  
  - アプレットを作成する
  
  -GConfItemの使用
• カレンダーデータの読み取り
  
  - 終日イベント
  
  -ToDo要素
  
  -タイムゾーン
• プロジェクトファイルとその他の雑学
  
  - インストールスクリプト

免責事項：

Harmattanのドキュメントは非常に少なく、完全に輝くわけではないため、ここに書かれている内容の大部分は、バイナリを入力して掘ることによって把握する必要がありました。 おそらく、いくつかのパスは最適ではありません。 この記事で説明されていることを行う簡単な方法を知っている場合は、コメントに書いてください。

イベントを表示する

アプリケーションの最も重要で基本的な機能は、フィードに要素を追加することです。 2つの方法があります：

• シンプル-MEventFeedクラスを通じて。
• より難しい-DBusを使用。
• half- DBusのラッパーがあり、Johan Paul（Johan Paul）によって書かれ、次の場所で表示できます： gitorious.org/libharmattaneventview

最後のオプションについては検討しませんが、最初の2つについては検討します。

クラスMEventFeed

このオプションは、Harmattanのドキュメントで提案されています。 彼はaのように単純です。 2つのメソッドを持つMEventFeedクラスがあります（オンラインドキュメントによると3つのメソッドがありますが、3番目のメソッドはQtSDKターゲットでは使用できません）： addItemおよびremoveItemsBySourceName 。 最初のメソッドはフィードに要素を追加し、2番目のメソッドは同じソースを持つすべての要素を削除します。

qlonglong addItem(const QString &icon, //  ( ) const QString &title, //  ( ) const QString &body, //    const QStringList &imageList, //  ,      (  Facebook') const QDateTime ×tamp, //   (      ) const QString &footer, //  ( ,   ) bool video, //      imageList    (          ,   ) const QUrl &url, // ,        const QString &sourceName, // Id  const QString &sourceDisplayName //   (      . ,     ) );
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

これを初めて見たとき、私の顔は伸びていました。 ゲッターとセッターで小さなクラスを作成して渡すことは本当に不可能ですか？ さて、わかりました、与えられたもの、私たちはそれで働いています。 コメントは、各パラメーターの意味を示しています。 このメソッドは、要素のIDまたは-1を返します（何か問題が発生した場合。ほとんどの場合、これらは誤って指定されたパラメーターです）。

 void removeItemsBySourceName(const QString &sourceName);
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

さて、ここではすべてが簡単です。 前のメソッドで指定された同じIDを渡し、このIDを持つすべての要素が削除されます。



このパスは単純で便利ですが、可能性が制限されています。 実際には、URLをナビゲートすることに加えて、dbusメソッドを呼び出すことができます。 ただし、このクラスの助けを借りて、呼び出されたメソッドのシグネチャを指定することはできません。したがって、より普遍的なフィードの操作方法（dbus経由）を検討します。

DBus

 QDBusMessage message = QDBusMessage::createMethodCall( "com.nokia.home.EventFeed", "/eventfeed", "com.nokia.home.EventFeed", "addItem"); QList<QVariant> args; QVariantMap itemArgs; itemArgs.insert("title", "Calendar"); itemArgs.insert("icon", icon); itemArgs.insert("body", body); itemArgs.insert("timestamp", QDateTime::currentDateTime().addDays(1).toString("yyyy-MM-dd hh:mm:ss")); itemArgs.insert("sourceName", "SyncFW-calendarfeed"); itemArgs.insert("sourceDisplayName", "Calendar Feed"); itemArgs.insert("action", action); QDBusConnection bus = QDBusConnection::sessionBus(); args.append(itemArgs); message.setArguments(args); bus.callWithCallback(message, this, SLOT(dbusRequestCompleted(QDBusMessage)));
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ここにはさらにコードがありますが、アクションプロパティを設定する機能があります（dbusメソッドのシグネチャを格納しますが、これについては後で詳しく説明します）。 MEventFeedにあったすべてのパラメーター、addItemおよびplus actionを設定できます。 覚えておくべき唯一のことは、タイムスタンプの転送です。 "-- ::".



の形式で1行で送信され"-- ::".





アイコンへのパスの代わりにアイコンを使用して、アイコンを使用できます（カレンダーフィードが使用するものです。IDicon-l-calendar-12のアイコンが使用されます 。12の代わりにリストの最初のイベントの番号が置き換えられます）。



また、DBusを使用すると、ID（MEventFeedでは使用できません）でアイテムを削除および更新できます。

Harmattan DBus署名ストレージ機能

私はこのパズルを数晩夕方に解決しなければなりませんでしたが、最終的に（ hexdump 、 stringsなど、およびそのような母親を使用して）メソッドシグネチャを渡して正しく呼び出されるようにする方法を理解することができました。



次の署名があります。

com.nokia.Calendar / com.nokia.maemo.meegotouch.CalendarInterface.showMonthView 2011 11 25

デバイスでこれらのパラメーターを使用してこのメ​​ソッドを呼び出すと、2011年11月25日に選択された日付の月表示でカレンダーが開きます。



このメソッドを呼び出すには、要素のアクションに次の行を追加する必要があります。

com.nokia.Calendar / com.nokia.maemo.meegotouch.CalendarInterface showMonthView AAAAAgAAAAfb AAAAAgAAAAAL AAAAAgAAAAAZ



さて、インターフェイスとメソッド名の間にはスペースがあり、すべてが明確です。 QDBusMessageコンストラクターでは、 2つの異なるパラメーターにも分割されます。 しかし、3つの数字の代わりに3つの奇妙な文字列引数とは何ですか？ あなたが知っているとき、すべてが非常に簡単です、hehe（夕方に2つまたは3つを殺し、バイナリとdbusメソッドで掘り返しました）。 これは、 QDataStreamにシリアル化されたQVariantオブジェクトのBase64です。



そのような行を生成するためのヘルパーメソッド：

 QString CalendarFeedPlugin::base64SerializedVariant(const QVariant &value) const { QByteArray ba; QDataStream stream(&ba, QIODevice::WriteOnly); stream << value; return ba.toBase64(); }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

dbusメソッドのシグネチャが格納されているHarmattanのあらゆる場所で、このような表記法が使用されていることが疑われます。

Syncfw

フィード要素を作成する方法を学びました。 ここで、何らかの方法で定期的に追加する必要があります。 バッテリーを食べる悪魔を囲い込むのではなく、可能な限りシステムに統合して、いつ更新するかを決定することをお勧めします。



この目的のために、Harmattanにはプラグインを作成できるSyncFWフレームワークがあります。 このプラグインは、指定されたパラメーターに従ってポーリングされます。 プラグインは、メタデータと共有ライブラリの2つの部分に論理的に分割されています。



重要な点： PR1.0では、新しいプラグインをインストールした後にデバイスを再起動する必要があります。 PR1.1では、この問題を回避できます（インストールスクリプトのセクションを参照）。 ただし、プラグインの更新には常に再起動が必要です。 これがないと、古いメタデータが新しいメタデータと共に使用されるだけです（再起動せずにアンロードできますが、この方法はわかりません）。



もう1つの重要なポイント：例でcalendarfeed名が使用されている場合は常に、プラグイン名が必要であることが理解されています（この場合、ライブラリはlib <plugin_name> -client.so、つまり、この場合はlibcalendarfeed-client.soと呼ばれます）。 プラグインの名前にハイフンがあってはなりません。 理想的には-ラテン文字のみ、数字の使用も許可されると思います（チェックしませんでした）。

メタデータ

プラグインを説明するには、次のファイルが必要です。

• /etc/sync/profiles/client/calendarfeed.xml
• /etc/sync/profiles/service/calendarfeed.xml
• /etc/sync/profiles/sync/calendarfeed.xml

/etc/sync/profiles/client/calendarfeed.xml

 <?xml version="1.0" encoding="UTF-8"?> <profile name="calendarfeed" type="client" > </profile>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

クライアント側のプロファイルを作成するだけです（共有ライブラリがクライアントとして機能します）



/etc/sync/profiles/service/calendarfeed.xml

 <?xml version="1.0" encoding="UTF-8"?> <profile name="calendarfeed" type="service"> <key name="destinationtype" value="offline"/> <profile name="calendarfeed" type="client" > </profile> </profile>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

サービスプロファイルを作成し、オフラインで動作できることを示します。 つまり、プラグインは正常に機能するためにインターネット接続を必要としません（Harmattanのドキュメントではこれは不可能であると記載されていますが、実際には機能しています）。 顧客プロファイルも示されます。



/etc/sync/profiles/sync/calendarfeed.xml

 <?xml version="1.0" encoding="UTF-8"?> <profile name="calendarfeed" type="sync" > <key name="displayname" value="Calendar Feed"/> <key name="enabled" value="true" /> <key name="use_accounts" value="false" /> <key name="hidden" value="true" /> <profile type="service" name="calendarfeed" > </profile> <schedule enabled="true" interval="20" days="1,2,3,4,5,6,7" syncconfiguredtime="" time=""> </schedule> </profile>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

同期プロファイルを作成します。 プロファイルノードのコンテンツ：

• displayname-UIに表示される名前
• 有効-プロファイルがアクティブかどうか
• use_accounts-アカウントフレームワークを使用するかどうか
• 非表示-このプロファイルはUIに非表示です
• プロファイル-サービスプロファイル

ここで最も重要な部分は、もちろんスケジュールです。 このノードからの情報に従って、プラグインがポーリングされます。 この場合、曜日に関係なく20分ごとに質問されます。



しかし、週末と平日の夕方には30分ごとに、平日は15分ごとに1回質問する必要がある場合はどうすればよいでしょうか？ 30分で明らかです。 20から30に変更すると、すべて問題ありません。 追加のスケジュール時間を設定するには、 ラッシュノードをスケジュールサブノードとして有効にする必要があります。

 <rush begin="00:00:00" enabled="true" interval="15" end="17:00:00" days="1,2,3,4,5"/>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

共有ライブラリ

ライブラリには、プラグインを作成および削除するために、1つのButeo :: ClientPlugin下位クラスと2つのextern関数が必要です。

 class CalendarFeedPlugin : public Buteo::ClientPlugin { Q_OBJECT public: CalendarFeedPlugin( const QString &pluginName, const Buteo::SyncProfile &profile, Buteo::PluginCbInterface *cbInterface ); virtual ~CalendarFeedPlugin(); virtual bool init(); virtual bool uninit(); virtual bool startSync(); virtual void abortSync(Sync::SyncStatus status = Sync::SYNC_ABORTED); virtual Buteo::SyncResults getSyncResults() const; virtual bool cleanUp(); public slots: virtual void connectivityStateChanged( Sync::ConnectivityType type, bool state ); protected slots: void syncSuccess(); void syncFailed(); void updateFeed(); void dbusRequestCompleted(const QDBusMessage &reply); void dbusErrorOccured(const QDBusError &error, const QDBusMessage &message); private: void updateResults(const Buteo::SyncResults &results); QString base64SerializedVariant(const QVariant &value) const; Buteo::SyncResults m_results; }; extern "C" CalendarFeedPlugin* createPlugin( const QString& pluginName, const Buteo::SyncProfile &profile, Buteo::PluginCbInterface *cbInterface ); extern "C" void destroyPlugin( CalendarFeedPlugin *client );
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

このヘッダーには、最低限必要なクラスに近いクラスが含まれます（ 保護されたスロットとプライベートセクションが削除された場合、最小クラスになります）。 それ以外はすべて仮想メソッドのオーバーライドです（ほとんどの場合、純粋仮想）。



仮想bool init（）;

これは最初に呼び出され、プラグインがそれ自体を初期化できるかどうかを確認するために必要です。 成功した場合、trueを返し、プロセスはさらに進みます。



仮想ブールuninit（）;

プラグインがアンロードされる前に呼び出され、通常はここでクリーニングが行われます。



仮想ブールstartSync（）;

このメソッドは、更新を開始できるかどうかを確認し、更新を開始する必要があります（非同期で）。 更新の開始に成功した結果を返します。



virtual void abortSync（Sync :: SyncStatus status = Sync :: SYNC_ABORTED）;

ユーザーが更新をキャンセルしたときに呼び出されます。 アカウント（このようなボタンがある場合）を操作する必要があります。この場合、ユーザーは更新をキャンセルする機会がありません。



virtual Buteo :: SyncResults getSyncResults（）const;

最後の更新の結果を返します。



仮想ブールのクリーンアップ（）;

アカウントが削除されたときに呼び出されます。 この場合も、これは必要ありません（ただし、ドキュメントでは、後で使用できる可能性があると書かれています）。



virtual void connectivityStateChanged（Sync :: ConnectivityType type、bool state）;

接続ステータスが変更された場合に呼び出されます。 プラグインがネットワークで動作しない場合、このスロットも空になります。



最も興味深いメソッドはstartSync（）であることがわかります。 そして当然です。 その中で、タイマーに（つまり、非同期で）要素をFeedに追加するメソッドを実行します。 他のすべての方法はほとんどが実用的です。

SyncFWプラグインのローカライズ

当然、この小さなライブラリはローカライズについて何も知りません。 そのため、目的の場所で手動で突く必要があります（言語が自動的に選択します。主なことは、目的の.qmファイルのセットを指定することです）。

 MLocale locale; locale.installTrCatalog("calendarfeed"); //... itemArgs.insert("title", locale.translate("", "calendar_feed_item_title"));
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

更新ボタンの更新

インターネットなしで更新する場合と同様に、ドキュメントでは、更新ボタンは埋め込みアプリケーションのみを更新できることが示されています（読み取り：Twitter、Facebook、RSSフィード、APモバイル）。 しかし、私たちは独自の方法で進んでいるので、このステートメントを自分で検証しようとします。



Feedデータベース（ /home/user/.config/meegotouchhome-nokia/eventsfeed.dataファイルにあり、通常のSqliteデータベース）には、イベント、画像、refreshactionsの3つのテーブルがあります。 この場合、最初の2つはほとんど関心がありませんが、3番目は非常に興味深いものです。 彼女には属性アクションが 1つしかありません。 Feed要素を追加することで名前がすでによく知られているので、ここでdbusメソッド呼び出しのシグネチャを（上記の形式で）配置しようとします。 そしてそれは動作します！ ドキュメントは再び間違っていました。 さて、大丈夫ですが、今では必要な機能を実装できます。 システムへの最大限の統合の道をたどっていますが、アプリケーションがこのボタンに応答しない場合は非常に奇妙です。



さて、ボタンにバインドする方法を決定しましたが、プラグインをスケジュール外で呼び出す方法は？ これを行うには、1つの引数（クライアントプロファイルの名前）を持つdbusメソッドcom.meego.msyncd / synchronizer com.meego.msyncd.startSyncがあります。



細かい部分が残っています...アクションをこのテーブルに追加する方法は？ 実際、SQLクエリではありません。 幸いなことに、dbusのaddItemの隣にはaddRefreshActionメソッドがあり、署名付きの行を渡すことができます。



少し後に、 からaddRefreshActionを呼び出す場所を見つけます。 それまでの間、アプリケーション自体を続行します。

カスタマイズ用アプレット

アプリケーションの設定が必要です。 論理的な質問は、それらをどこに置くか？ 別のアプリケーションにして、他のアプリケーションの隣に配置しますか？ いいえ、オプションではありません。 ランチャーにはそれらが多すぎます。 非常にまれにしか使用されない別の更新プログラム（更新ごとに約1回）は、明らかに不要です。 この場合、アプレットを設定階層に追加する機会が役立ちます。 また、画面に余分なアイコンはありません。フィードでTwitterとFacebookの表示を有効/無効にする横に呼び出しボタンを追加できます。

アプレット作成

MeeGo Harmattanは、設定で有効にできるアプレットを作成する3つの方法を提供します。

• 宣言的 -設定セットはxmlファイルによって記述されます
• バイナリ -DcpAppletIfから継承した共有ライブラリを作成します
• 外部 -通常のアプリケーションを使用する

3番目のオプションは、設定からアプリケーションに切り替えるときに遅延を引き起こす可能性があるため、まったく適切ではありません（また、ドキュメントではお勧めできません）。

2番目のオプションは最も柔軟ですが、最初のオプションよりも複雑です。

最初のオプションは最小限の柔軟性ですが、同時に可能な限りシンプルです。



特に複雑な設定は必要ないため、最初の方法を使用します。



それには2つのファイルが必要です。

• /usr/share/duicontrolpanel/desktops/calendarfeed.desktop-何が何と呼ばれ、どこにあるかを記述した.desktopファイル（一般に、.desktopファイルの完全に標準的な目的）
• /usr/share/duicontrolpanel/uidescriptions/calendarfeed.xml-画面に表示される一連の設定の説明

それらを順番に分析します。



/usr/share/duicontrolpanel/desktops/calendarfeed.desktop

 [Desktop Entry] Type=ControlPanelApplet Name=Calendar Feed X-logical-id=calendar_feed_title X-translation-catalog=calendarfeed Icon= X-Maemo-Service=com.nokia.DuiControlPanel X-Maemo-Method=com.nokia.DuiControlPanelIf.appletPage X-Maemo-Object-Path=/ # this has to be identical to the value in Name X-Maemo-Fixed-Args=Calendar Feed [DUI] X-DUIApplet-Applet=libdeclarative.so [DCP] Category=Events Feed Order=100 Part=calendarfeed.xml Text2=Calendar events at Feed screen Text2-logical-id=calendar_feed_subtitle
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

最初のセクションは標準です。 X-Maemo- *パラメーターに加えて、このアプレットを開くために呼び出すdbusメソッドと呼び出す引数を記述しない限り。



DUIセクションでは、共有ライブラリの接続方法について説明します。 私たちの場合（宣言アプレット）は、常にlibdeclarative.soです。 バイナリアプレットの場合、DcpAppletIfの子孫を持つ共有ライブラリ名はここにあります。



DCPセクションには、挿入する場所、場所、および内容に関する情報が含まれています。 この場合、イベントフィードの設定に入ります（TwitterとFacebookのスイッチと同じ場所）。 Text2は2行目です（通常、説明またはアイテムの現在の状態が表示されます）。



/usr/share/duicontrolpanel/uidescriptions/calendarfeed.xml

 <settings> <group title="calendar_feed_setting_group_behavior"> <boolean key="/apps/ControlPanel/CalendarFeed/EnableFeed" title="calendar_feed_setting_publish_to_feed"></boolean> <boolean key="/apps/ControlPanel/CalendarFeed/FillWithFuture" title="calendar_feed_setting_fill_with_future"></boolean> <boolean key="/apps/ControlPanel/CalendarFeed/LimitFuture" title="calendar_feed_setting_limit_future"></boolean> <integer key="/apps/ControlPanel/CalendarFeed/LimitDaysSize" title="calendar_feed_setting_future_limit_size" min="1" max="31"></integer> </group> <group title="calendar_feed_setting_group_display"> <integer key="/apps/ControlPanel/CalendarFeed/FeedSize" title="calendar_feed_setting_events_number" min="1" max="5"></integer> <boolean key="/apps/ControlPanel/CalendarFeed/ShowCalendarBar" title="calendar_feed_setting_show_calendar_bar"></boolean> <text key="/apps/ControlPanel/CalendarFeed/DateFormat" title="calendar_feed_setting_date_format">MMM, d</text> <boolean key="/apps/ControlPanel/CalendarFeed/HighlightToday" title="calendar_feed_setting_highlight_today"></boolean> </group> </settings>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

笑いますが、この例では、宣言型アプレットに含まれるノードを除くすべてのタイプのノードをリストします。



すべてのタイプのノードについて、2つのパラメーターが標準です。

• key -GConfのキー
• title -UIに表示される名前。 翻訳する文字列のIDを指定できます（例で行われたように）

はい！ サプライズサプライズ！ Qt-shny MeeGo HarmattanはすべてGConfを使用して内部設定を保存します。 ところで、バックアップに入るのはGConfの設定です。



グループ -一種のグループボックスの役割を実行します（2番目のスクリーンショットの表示例。動作と外観の2つのグループがあります）。 ドキュメントにはパラメーターがないと記載されていますが、それでもタイトルは正常に機能します。

ブール -スイッチ。 最も普通の...

整数 -整数値を選択するためのスライダー。 標準に加えて、minとmaxの2つのパラメーターがあります。 スライダーの範囲を記述します。

テキスト -テキストを入力するためのフィールド。 ちなみに、このタイプの場合、タイトルはドキュメントでも宣言されていませんが、それが機能することはすでにわかっていると思います。

選択 -ボタンのグループ。各ボタンは、1つのパラメーターを持つサブオプションで記述されます-キー。この場合、UIに表示される値の役割を果たします。 各オプションには、番号付きのテキストが必要です（GConfに保存されます）。

GConfItemを使用する

GConfが使用されていますが、それでもGConfを操作するためのQtクラス-GConfItemがあります。 それから2つのメソッドが必要です： value（）とset（） 最初はQVariantのパラメーターの値を返し、2番目はパラメーターの値を変更します。



ただし、すべてのタイプがサポートされているわけではありません。 次のルールが適用されます（gconfおよびqvariant機能による）：

• QVariant ::無効-gconfパラメーターがありません
• QVariant :: Int 、 QVariant :: Double 、 QVariant :: Boolは同等の型に変換します
• QVariant ::文字列はutf8エンコードでのみサポートされます
• QVariant :: StringList -utf8の文字列のリスト。
• QVariant ::リストリストQVariant :: Int 、 QVariant :: Double 、 QVariant :: BoolまたはQVariant :: String （ QVariant :: StringListとして返されます ）、すべての要素は同じ型でなければなりません
• 他のすべてのタイプ（両側）は無視されます。

宣言型アプレットの場合、アプレットは文字列、ブール値、整数を提供するため、これは完全に適しています。

GConfItemの例

 bool fillWithFuture = false; GConfItem fillConfItem("/apps/ControlPanel/CalendarFeed/FillWithFuture"); QVariant fillVariant = fillConfItem.value(); if (fillVariant.isValid()) fillWithFuture = fillVariant.toBool(); else fillConfItem.set(false);
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

カレンダーデータの読み取り

実際、アプリケーションの最も重要な部分です。 最後に、そこからイベントをもたらします。 理論的には、すべてがQt Mobilityを介して機能し、完全にまたはそれに近い状態で機能する必要があります。 結局のところ、MeeGoはコアでQtを使用しています。 n9をリリースしたNokiaは、本質的にQtの所有者です。 すべてを可能な限り統合する必要がありますか？ シュシャッツ、ええ。 いつものように、ここには豚が植えられています。 しかし、実際にはこれと投稿のために。 将来の世代のためにこれらの豚を記述すること。

終日イベント

カレンダーには、終日（つまり、時間なし）のイベントを設定する機能があります。 QOrganizerには、イベントのallDayパラメーターもあります。 これは常に偽です。 カレンダーに表示されるものに関係なく。 Vagueは、逆のことが真実であるという苦痛を推測します（つまり、QOrganizerを介してallDayイベントを作成すると、カレンダーに何か問題が発生します）。 それでも、イベントがallDayであるかどうかを判断するためのヒューリスティックな方法があります。

 if (!isAllDay && startDateTime.time().hour() == 0 && startDateTime.time().minute() == 0 && endDateTime.time().hour() == 0 && endDateTime.time().minute() == 0 && startDateTime.date().addDays(1) == endDateTime.date()) isAllDay = true;
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ToDoアイテム

QOrganizerは、ToDo要素があることを知っています。 彼はそれらの終了日も保存します。 それだけでは、ToDoが完了しているかどうかを判断することは不可能です。 それは不可能です。 QOrganizer自体にはこのようなフラグがありますが、QOrganizerが基礎となるレベルからデータを受け取ったときにコックされません。 前の問題とは異なり、Qt Mobilityによる解決策はありません。 そして、少なくともQtMobility経由ではないようです（少なくとも次のファームウェアまで）。

タイムゾーン

見つかった最初の2つのジャムに加えて、3番目も発見されました。 もっと楽しくてエキゾチック。 ポイントです。 カレンダーがシステムに保存されるデータ構造には、イベントがどのタイムゾーンで記録されるフィールドがあります。 つまり、「開始日」フィールドに同じ値を持つ2つのイベントがある場合、それらが同時に開始するという事実ではありません。 時間を正しく判断するには、両方のフィールドが必要です。 したがって、UTCで作成されたエクスポートされたカレンダーを使用する場合、またはCalDAVによって同期される共通のカレンダーを使用し、異なるタイムゾーンのユーザーがそれを使用する場合、誤った時間が表示されます。



カレンダーシステムは、2つのレベル（高および低）で構築されています。 QtMobilityはQOrganizerモジュールと一緒に使用できます。QOrganizerモジュールは使いやすいですが、上記の現象の影響を受けます（タイムゾーンを持つフィールドの存在を疑うだけではありません）。 低い位置にあるmKCalは、常に正しいデータを返しますが、使用するにはあまり便利ではありません。



カレンダーフィードは、もともとQOrganizerを使用して作成されました。しかし、1つのバグ（重大、一部のエキゾチックなケースでの時間の誤った表示に関連する）の​​出現後、ある種の移行期間が始まりました。現時点では、プロジェクトは両方のレベルを使用しています。最初に、すべてのイベントがQOrganizerを介して収集され、次に、mKCalを介して収集されたイベントに応じて、日付の極端な境界がプロットされます。正しいデータは、後者から取得されます（個別のデータ構造で）。その後、サイクルが最初に進み、必要に応じてデータが置き換えられます。



おそらく、前の段落を読んだ後、すぐに質問が現れました。すぐにmKCalに切り替える方が簡単ではありませんか？」実際、私は移行を考えています。しかし、このバグは非常に重く、すぐに修正する必要がありました。主な機能を実装する完全に新しいシステムへの移行には、2度考えられるようなバグがたくさんあります。したがって、二重の解決策を備えた緊急の修正プログラムを発行することを決定し、冷静に、すべての長所と短所を比較検討し、新しいシステムに切り替えました。



ところで、mKCal（これは論理的です）には、最初の2つの現象に関する正しい情報があります。

プロジェクトファイルとその他の雑学

そこで、実装メカニズムを見つけました。すべてをまとめることは残っています。まず、.proファイルを見てください

 TEMPLATE = lib TARGET = calendarfeed-client VERSION = 0.3.0 DEPENDPATH += . INCLUDEPATH += . \ /usr/include/libsynccommon \ /usr/include/libsyncprofile \ /usr/include/gq \ /usr/include/mkcal \ /usr/include/kcalcoren LIBS += -lsyncpluginmgr -lsyncprofile -lgq-gconf -lmkcal CONFIG += debug plugin meegotouchevents CONFIG += mobility MOBILITY += organizer QT += dbus #input SOURCES += \ calendarfeedplugin.cpp HEADERS +=\ calendarfeedplugin.h QMAKE_CXXFLAGS = -Wall \ -g \ -Wno-cast-align \ -O2 -finline-functions #install target.path = /usr/lib/sync/ system ("cd translations && lrelease -markuntranslated '' -idbased *.ts") client.path = /etc/sync/profiles/client client.files = xml/calendarfeed.xml sync.path = /etc/sync/profiles/sync sync.files = xml/sync/calendarfeed.xml service.path = /etc/sync/profiles/service service.files = xml/service/calendarfeed.xml settingsdesktop.path = /usr/share/duicontrolpanel/desktops settingsdesktop.files = settings/calendarfeed.desktop settingsxml.path = /usr/share/duicontrolpanel/uidescriptions settingsxml.files = settings/calendarfeed.xml translations.path = /usr/share/l10n/meegotouch translations.files += translations/*qm INSTALLS += target client sync service settingsdesktop settingsxml translations OTHER_FILES += \ qtc_packaging/debian_harmattan/rules \ qtc_packaging/debian_harmattan/README \ qtc_packaging/debian_harmattan/manifest.aegis \ qtc_packaging/debian_harmattan/copyright \ qtc_packaging/debian_harmattan/control \ qtc_packaging/debian_harmattan/compat \ qtc_packaging/debian_harmattan/changelog \ qtc_packaging/debian_harmattan/postinst \ qtc_packaging/debian_harmattan/prerm
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

Calendarfeed-clientという名前（SyncFWによるもの）で、共有ライブラリ（SyncFWセクションから覚えているように、プラグインはまさにそれである必要があります）を構築しています。

必要なすべてのシステムヘッダーとライブラリを接続します。

接続meegotucheventsをするためにMEventFeed（私たちはDBUSを経由して追加し、それでも除去方法の呼び出しに残されますが）。

追加qdbusと移動度は、主催者の流れだけでなく、どのような私たちのヘッダとソースファイルを指摘しています。

これまでのところ、すべてが標準です。



インストールコメントの後のすべての最も重要な。

すべてのxmlおよびデスクトップを必要なフォルダー（記事の対応するセクションに示されている）に配置し、そのフォルダーにローカライズを配置します/ usr /このコンテンツ共有/ L10N / meegotouch。この場合、ファイルはcalendarfeed_ru.qmの形式である必要があります。ここで、calendarfeedは、デスクトップファイルのX-translation-catalogパラメーターで指定されたものです。

インストールスクリプト

SyncFWプラグインには興味深い機能が1つあります。彼ら自身は、正しくインストールおよび削除する方法を知りません。再起動が必要です。さらに、削除するときはフィードからアイテムを削除する必要があります。また、インストール時にも更新ボタンが機能するように、refreshActionを追加すると便利です。



debパッケージに追加できるこのための2つのスクリプトがあります。

• postinst-インストール直後に実行
• prerm-アンインストールの直前に実行

postinst

 #!/bin/sh /usr/bin/aegis-exec -s -u user dbus-send --dest=com.meego.msyncd --print-reply /synchronizer com.meego.msyncd.installPlugin string:'calendarfeed' /usr/bin/aegis-exec -s -u user dbus-send --dest=com.nokia.home.EventFeed --print-reply /eventfeed com.nokia.home.EventFeed.addRefreshAction string:'com.meego.msyncd /synchronizer com.meego.msyncd startSync AAAACgAAAAAYAGMAYQBsAGUAbgBkAGEAcgBmAGUAZQBk' gconftool -s /apps/ControlPanel/CalendarFeed/EnableFeed -t bool true /usr/bin/aegis-exec -s -u user dbus-send --dest=com.meego.msyncd --print-reply /synchronizer com.meego.msyncd.startSync string:'calendarfeed' exit 0
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ここでは、プラグインをインストールし（PR1.1でのみ機能し、PR1.0ではデバイスを再起動する必要があります）、refreshActionを追加し、アプリケーションをオンにしてFeedのアイテムを手動で更新すると明示的に言います。



予言

 #!/bin/sh /usr/bin/aegis-exec -s -u user dbus-send --dest=com.meego.msyncd --print-reply /synchronizer com.meego.msyncd.uninstallPlugin string:'calendarfeed' /usr/bin/aegis-exec -s -u user dbus-send --dest=com.nokia.home.EventFeed --print-reply /eventfeed com.nokia.home.EventFeed.removeItemsBySourceName string:'SyncFW-calendarfeed' exit 0
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

フィードからプラグインと要素を削除します。



ちなみに、指定されたプラグインのインストール方法は最初のインストールには役立ちますが、共有ライブラリを更新する場合、リブート前に古いライブラリが引き続き使用されます（メモリからアンロードされません）。デバッグ中に不便な点があります。

おわりに

はい記事はついに終わりました。私はそれを書くのにうんざりしており、あなたはそれを読むのに少しうんざりしていると思います。しかし、この記事のおかげで、次のことを学びました。

• アイテムをイベントフィードに追加する方法
• 押されたときにこの要素にdbusメソッド呼び出しを追加する方法
• dbus- ( , ) Harmattan'
• SyncFW
• Settings
• Refresh
• Harmattan QOrganizer (, - )
• Calendar Feed :)

実際、もちろん、この投稿には、開発中に出会ったすべてのものを含めませんでした。そして、すべてが詳細に説明されているわけではなく、この投稿はすでに長すぎます。私の目標は、これがどのように行われるかを示すことであり、理論的な情報やこの情報への道を示すことではありませんでした。しかし、この情報も興味深い場合は、私のブログでこのアプリケーションの開発中にいくつかの「旅行メモ」を読むことができます（プロファイル内のリンク）。



そして最後に、リンクの束：

• OVIストアでのカレンダーフィード
• ソースカレンダーフィード
• Qt Ambassador Showcaseのカレンダーフィード
• Harmattan部品のドキュメント
• Harmattan開発の概要

あなたが興味を持っていたと思います。以上です！