maryjane
/
syncevolution
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
syncevolution/src/backends/akonadi/README

44 lines
1.6 KiB
Plaintext
Raw Normal View History

rewrite of Akonadi backend for SyncEvolution This patch adds the necessary boiler-plate to compile Sascha's Akonadi backend as part of SyncEvolution. It changes the change tracking so that it is now based on the revision number maintained by Akonadi. This removes the need to keep the sync process running all the time to record changes. Finding local databases (= collections) is implemented inside the backend, with several TODOs in the code to make this nicer. Tests were added as part of copying the boiler-plate code from the Evolution backend. However, this depends on being able to open local databases following the name pattern <prefix>_<type>_[12], with <prefix> from CLIENT_TEST_EVOLUTION_PREFIX and <type> one of ical20/vcard30/itodo20/text. This does not work at the moment. Because the implementation of isEmpty() always returns "false", the logic which checks whether a slow sync is acceptable will err on the side of caution and reject slow sync, even if the local side has no data.
2010-01-10 18:54:33 +01:00
Getting started with Akonadi on Debian testing:
aptitude install libakonadi-dev akonadi-server \
libqt4-dev kdepim-runtime \
Akonadi: fixed compile and runtime issues Due to bitrot the Akonadi backend and KWallet support code no longer worked. Moved the common code for KApplication initialization into libsyncevolution's SyncContext::initMain() and fixed autotools rules. The old code always tried to contact an X server (default constructor of KApplication). That doesn't seem to be necessary and is avoided now. Even better might be to skip KApplication entirely and instead use QCoreApplication and KComponentData, as suggested by http://api.kde.org/4.x-api/kdelibs-apidocs/kdeui/html/classKApplication.html KAboutData was incorrectly passed the address of a string pointer, not the pointer itself. Testing the Akonadi backend in client-test failed because client-test always overwrites the "backend" value with "Test_kde_[contact/event/..]._[1/2]". Now this special case is detected. The backend then uses the first resp. second resource that it finds.
2012-01-27 16:05:06 +01:00
akonadiconsole \
rewrite of Akonadi backend for SyncEvolution This patch adds the necessary boiler-plate to compile Sascha's Akonadi backend as part of SyncEvolution. It changes the change tracking so that it is now based on the revision number maintained by Akonadi. This removes the need to keep the sync process running all the time to record changes. Finding local databases (= collections) is implemented inside the backend, with several TODOs in the code to make this nicer. Tests were added as part of copying the boiler-plate code from the Evolution backend. However, this depends on being able to open local databases following the name pattern <prefix>_<type>_[12], with <prefix> from CLIENT_TEST_EVOLUTION_PREFIX and <type> one of ical20/vcard30/itodo20/text. This does not work at the moment. Because the implementation of isEmpty() always returns "false", the logic which checks whether a slow sync is acceptable will err on the side of caution and reject slow sync, even if the local side has no data.
2010-01-10 18:54:33 +01:00
kdepimlibs5-dev
Controlling Akonadi server:
akonadictl start/stop/restart
Debugging Akonadi:
Akonadi: fixed compile and runtime issues Due to bitrot the Akonadi backend and KWallet support code no longer worked. Moved the common code for KApplication initialization into libsyncevolution's SyncContext::initMain() and fixed autotools rules. The old code always tried to contact an X server (default constructor of KApplication). That doesn't seem to be necessary and is avoided now. Even better might be to skip KApplication entirely and instead use QCoreApplication and KComponentData, as suggested by http://api.kde.org/4.x-api/kdelibs-apidocs/kdeui/html/classKApplication.html KAboutData was incorrectly passed the address of a string pointer, not the pointer itself. Testing the Akonadi backend in client-test failed because client-test always overwrites the "backend" value with "Test_kde_[contact/event/..]._[1/2]". Now this special case is detected. The backend then uses the first resp. second resource that it finds.
2012-01-27 16:05:06 +01:00
akonadiconsole
rewrite of Akonadi backend for SyncEvolution This patch adds the necessary boiler-plate to compile Sascha's Akonadi backend as part of SyncEvolution. It changes the change tracking so that it is now based on the revision number maintained by Akonadi. This removes the need to keep the sync process running all the time to record changes. Finding local databases (= collections) is implemented inside the backend, with several TODOs in the code to make this nicer. Tests were added as part of copying the boiler-plate code from the Evolution backend. However, this depends on being able to open local databases following the name pattern <prefix>_<type>_[12], with <prefix> from CLIENT_TEST_EVOLUTION_PREFIX and <type> one of ical20/vcard30/itodo20/text. This does not work at the moment. Because the implementation of isEmpty() always returns "false", the logic which checks whether a slow sync is acceptable will err on the side of caution and reject slow sync, even if the local side has no data.
2010-01-10 18:54:33 +01:00
Configuring without Evolution and with Akonadi:
<path>/syncevolution/configure --with-synthesis-src=<path>/libsynthesis \
CFLAGS="-g -Wall -Werror -Wno-unknown-pragmas" \
CXXFLAGS="-g -Wall -Werror -Wno-unknown-pragmas" \
--disable-shared --enable-static \
--enable-libcurl \
--enable-unit-tests --enable-integration-tests \
Akonadi: first functional version TODOs resolved, adapted to backend API changes.
2010-08-14 13:30:46 +02:00
--disable-ecal --disable-ebook --disable-libsoup \
--enable-akonadi --enable-kwallet
rewrite of Akonadi backend for SyncEvolution This patch adds the necessary boiler-plate to compile Sascha's Akonadi backend as part of SyncEvolution. It changes the change tracking so that it is now based on the revision number maintained by Akonadi. This removes the need to keep the sync process running all the time to record changes. Finding local databases (= collections) is implemented inside the backend, with several TODOs in the code to make this nicer. Tests were added as part of copying the boiler-plate code from the Evolution backend. However, this depends on being able to open local databases following the name pattern <prefix>_<type>_[12], with <prefix> from CLIENT_TEST_EVOLUTION_PREFIX and <type> one of ical20/vcard30/itodo20/text. This does not work at the moment. Because the implementation of isEmpty() always returns "false", the logic which checks whether a slow sync is acceptable will err on the side of caution and reject slow sync, even if the local side has no data.
2010-01-10 18:54:33 +01:00
This creates src/syncevolution and src/client-test which can be run under
a debugger directly.
Query databases:
syncevolution
Configuring syncevolution for contacts with Akonadi as backend:
source -> datastore rename, improved terminology The word "source" implies reading, while in fact access is read/write. "datastore" avoids that misconception. Writing it in one word emphasizes that it is single entity. While renaming, also remove references to explicit --*-property parameters. The only necessary use today is "--sync-property ?" and "--datastore-property ?". --datastore-property was used instead of the short --store-property because "store" might be mistaken for the verb. It doesn't matter that it is longer because it doesn't get typed often. --source-property must remain valid for backward compatility. As many user-visible instances of "source" as possible got replaced in text strings by the newer term "datastore". Debug messages were left unchanged unless some regex happened to match it. The source code will continue to use the old variable and class names based on "source". Various documentation enhancements: Better explain what local sync is and how it involves two sync configs. "originating config" gets introduces instead of just "sync config". Better explain the relationship between contexts, sync configs, and source configs ("a sync config can use the datastore configs in the same context"). An entire section on config properties in the terminology section. "item" added (Todd Wilson correctly pointed out that it was missing). Less focus on conflict resolution, as suggested by Graham Cobb. Fix examples that became invalid when fixing the password storage/lookup mechanism for GNOME keyring in 1.4. The "command line conventions", "Synchronization beyond SyncML" and "CalDAV and CardDAV" sections were updated. It's possible that the other sections also contain slightly incorrect usage of the terminology or are simply out-dated.
2014-07-28 15:29:41 +02:00
syncevolution --configure --datastore-property sync=none \
rewrite of Akonadi backend for SyncEvolution This patch adds the necessary boiler-plate to compile Sascha's Akonadi backend as part of SyncEvolution. It changes the change tracking so that it is now based on the revision number maintained by Akonadi. This removes the need to keep the sync process running all the time to record changes. Finding local databases (= collections) is implemented inside the backend, with several TODOs in the code to make this nicer. Tests were added as part of copying the boiler-plate code from the Evolution backend. However, this depends on being able to open local databases following the name pattern <prefix>_<type>_[12], with <prefix> from CLIENT_TEST_EVOLUTION_PREFIX and <type> one of ical20/vcard30/itodo20/text. This does not work at the moment. Because the implementation of isEmpty() always returns "false", the logic which checks whether a slow sync is acceptable will err on the side of caution and reject slow sync, even if the local side has no data.
2010-01-10 18:54:33 +01:00
--sync-property username=... \
--sync-property password=... \
scheduleworld
source -> datastore rename, improved terminology The word "source" implies reading, while in fact access is read/write. "datastore" avoids that misconception. Writing it in one word emphasizes that it is single entity. While renaming, also remove references to explicit --*-property parameters. The only necessary use today is "--sync-property ?" and "--datastore-property ?". --datastore-property was used instead of the short --store-property because "store" might be mistaken for the verb. It doesn't matter that it is longer because it doesn't get typed often. --source-property must remain valid for backward compatility. As many user-visible instances of "source" as possible got replaced in text strings by the newer term "datastore". Debug messages were left unchanged unless some regex happened to match it. The source code will continue to use the old variable and class names based on "source". Various documentation enhancements: Better explain what local sync is and how it involves two sync configs. "originating config" gets introduces instead of just "sync config". Better explain the relationship between contexts, sync configs, and source configs ("a sync config can use the datastore configs in the same context"). An entire section on config properties in the terminology section. "item" added (Todd Wilson correctly pointed out that it was missing). Less focus on conflict resolution, as suggested by Graham Cobb. Fix examples that became invalid when fixing the password storage/lookup mechanism for GNOME keyring in 1.4. The "command line conventions", "Synchronization beyond SyncML" and "CalDAV and CardDAV" sections were updated. It's possible that the other sections also contain slightly incorrect usage of the terminology or are simply out-dated.
2014-07-28 15:29:41 +02:00
syncevolution --configure --datastore-property sync=two-way \
--datastore-property type=kde-contacts \
--datastore-property evolutionsource=akonadi:?... \
rewrite of Akonadi backend for SyncEvolution This patch adds the necessary boiler-plate to compile Sascha's Akonadi backend as part of SyncEvolution. It changes the change tracking so that it is now based on the revision number maintained by Akonadi. This removes the need to keep the sync process running all the time to record changes. Finding local databases (= collections) is implemented inside the backend, with several TODOs in the code to make this nicer. Tests were added as part of copying the boiler-plate code from the Evolution backend. However, this depends on being able to open local databases following the name pattern <prefix>_<type>_[12], with <prefix> from CLIENT_TEST_EVOLUTION_PREFIX and <type> one of ical20/vcard30/itodo20/text. This does not work at the moment. Because the implementation of isEmpty() always returns "false", the logic which checks whether a slow sync is acceptable will err on the side of caution and reject slow sync, even if the local side has no data.
2010-01-10 18:54:33 +01:00
scheduleworld addressbook
Initial run:
syncevolution --sync slow scheduleworld addressbook
All following runs:
syncevolution scheduleworld