Kontact Windows Mobile: Difference between revisions

From KDE UserBase Wiki
 
(14 intermediate revisions by 2 users not shown)
Line 3: Line 3:


There are two platform we aim at first:  
There are two platform we aim at first:  
* [[Special:myLanguage/Kontact_Mobile|Kontact Mobile on maemo5]](on the N900)
* [[Special:myLanguage/Kontact_Mobile|Kontact Mobile on maemo5]] (on the N900)
* Windows Mobile 6.5 (on the HTC Touch Pro 2)
* [[Special:myLanguage/Kontact_Windows_Mobile|Windows Mobile 6.5]] (on the HTC Touch Pro 2)


{{Warning|1=This page is under heavy development at the moment, basically it is a copy of the respective page of instructions for maemo/N900.}}
{{Info|1=This page deals with Kontact Mobile for Windows Mobile. There is a separate page with [[Kontact_Mobile|information about Kontact Mobile for maemo]].}}


{{Info|1=The project is under heavy development at the moment - but we encourage people to test and feedback upon it.}}
{{Info|1=The project is under heavy development at the moment - but we encourage people to test and feedback upon it. '''Please read this page carefully.'''}}




== Installation and Update==
== Installation and Update==
==== Requirements ====
You need approximately 120MB of free, internal memory.


==== Installation ====
==== Installation ====


We offer a [http://files.kolab.org/local/windows-ce/Kontact-Mobile/unstable/ cab installation archive for WM 6.5]. Simply click that link on your  browser and save the file on the external memory card (be sure you have good and affordable internet access when doing so).
We offer a [http://files.kolab.org/local/windows-ce/Kontact-Mobile/unstable/ cab installation archive for WM 6.5]. Simply click that link on your  browser and save the file on the external memory card (be sure you have good and affordable Internet access when doing so).


Afterwards, execute the downloaded file (e.g. by navigating with the File Explorer to the download location).  
Afterwards, execute the downloaded file (e.g. by navigating with the File Explorer to the download location).  


The Installer will ask you for an installation locaiton, choose internal memory to be on the safe side.
The Installer will ask you for an installation location, notice that in even if you chose Card, most files will be installed to internal memory (but not your data).


Beware, the installation process takes a couple of minutes and the progress bar might not indicate progress for most of the time. Be patient. If nothing changed after half an hour, restart the phone.
Beware, the installation process takes a couple of minutes and the progress bar might not indicate progress for most of the time. Be patient. If nothing changed after half an hour, restart the phone.


Generally, in case of any issues during installation/deinstallation/usage process, restart the phone.
Generally, in case of any issues during installation/deinstallation/usage process, restart the phone.
Also, if installation succeeded, ''restart your phone.''.


==== Update ====
==== Update ====
Line 33: Line 39:
Before deinstallation, restart the phone.
Before deinstallation, restart the phone.


Then uninstall via the Settings page. Note that deinstallation takes about 10 minutes. The only feedback you will get is the spinning whell of colored balls.
Then uninstall via the Settings page. Note that deinstallation takes about 10 minutes. The only feedback you will get is the spinning wheel of colored balls.


==== Clear the configuration ====
==== Clear the configuration ====


If you want to start over or remove the configuration of the KDE components
If you want to start over or remove the configuration of the KDE components
completely, you need to deal with three places. ''First make sure that no kdepim related application is running anymore!'' Here are a number of commands to move the old files into a new backup directory 'dot.kde-20100728'.
completely, you need to deal with three places. ''First, restart your phone.''
 
Then start the File Explorer and remove following folders in "My Documents":
{{Input|1=cd
d=dot.kde-20100728
mkdir $d $d/dot.config
mv .config/akonadi $d/dot.config
mkdir -p $d/dot.local/share
mv .local/share/akonadi $d/dot.local/share
mv .kde $d
}}
 
Also, some resources (like unsent mails) can be found at ~/.local/share/local-mail, ~/.local/share/contacts, ~/.local/share/notes and ~/.local/share/.local-mail.directory .
 
There is one step that you might have to do after moving away (or deleting) the .kde directory. Some packages create a preset kdewallet.kwl file for the 'user', which you need to recreate. The script doing so usually can be rightfully called so by the user:


{{Input|1=/var/lib/dpkg/info/kdebase-runtime.postinst
{{Input|1=
}}
.config
It basically does:
.local
{{Output|1=mkdir -p /home/user/.kde/share/apps/kwallet
.kde
cp /usr/share/kde4/apps/kwallet/kdewallet.kwl /home/user/.kde/share/apps/kwallet
}}
}}


Line 63: Line 56:


After installation you will have find five new icons on your phone
After installation you will have find five new icons on your phone
that open the mail, calendar, addressbook, notes and tasks frontends
that open the mail, calendar, address book, notes and tasks frontends
to '''Kontact-Mobile'''.
to '''Kontact-Mobile'''.


Line 71: Line 64:
To do this you start mail, pull the flap <menuchoice>Actions</menuchoice> on the Homepage out, press <menuchoice>Accounts</menuchoice>, <menuchoice>Add Account</menuchoice> and then follow the instructions.  
To do this you start mail, pull the flap <menuchoice>Actions</menuchoice> on the Homepage out, press <menuchoice>Accounts</menuchoice>, <menuchoice>Add Account</menuchoice> and then follow the instructions.  


{{Note|1= you cannot do this from all frontends at the moment - but for email it works fine. If you should have an account on a Kolab Server, all applications willbe able to access the data fromit.}}
{{Note|1= You cannot do this from all frontends at the moment - but for email it works fine. If you should have an account on a Kolab Server, all applications will be able to access the data from it.}}


''You may'' change the following settings, by choosing the account and  
''You may'' change the following settings, by choosing the account and  
Line 84: Line 77:
One of the core features of '''Kontact Mobile''' is your ability to communicate safely using S/MIME or '''OpenPGP'''. We do not provide the generation of keys on the mobile phone - you will need to set-up your keys on a computer, e.g. by using '''Kleopatra'''.
One of the core features of '''Kontact Mobile''' is your ability to communicate safely using S/MIME or '''OpenPGP'''. We do not provide the generation of keys on the mobile phone - you will need to set-up your keys on a computer, e.g. by using '''Kleopatra'''.


Assuming you have all your keys together on your computer, you can find them most likely in ~/.gnupg. Please copy this folder to your N900, by simply connecting it via USB with your computer and copying the folder (Note: you might need to change some settings to be able to see hidden files. In '''Dolphin''' this would be <keycap>Alt + . </keycap>). Now disconnect your N900.
Instructions on how to transfer and use your keys on the mobile device will follow soon.
 
If you already have a .gnupg folder on your phone, consider making a backup or deleting it before you do next steps.
 
Close all '''Kontact''' mobile applications. Open '''X Terminal''' on the N900. If you copied the .gnupg to the root folder of your MemoryCard on your N900 (Default Name: 'MyDocs') the following commands in X Terminal will do the job for you:
 
{{Input|1=mv MyDocs/.gnupg ~/.gnupg
chmod 700 ~/.gnupg
}}
 
Now you should be able to read and write signed and encrypted messages.


== Using it: Ideas and Concepts ==
== Using it: Ideas and Concepts ==
Line 111: Line 94:


Please report any problems to [https://bugs.kde.org our Bugs page], where you also might find some hot workarounds.
Please report any problems to [https://bugs.kde.org our Bugs page], where you also might find some hot workarounds.
Use "Windows CE" as the target platform and enter komo3 as keyword to help us being fast in our response.


Note that we have created own categories for the mobile products, so please make use of that. For every problem you report, we need to know the version of Kontact Mobile you are running (you find it in the About Dialog, which is in the Actions/Application flap).
Note that we have created own categories for the mobile products, so please make use of that. For every problem you report, we need to know the version of Kontact Mobile you are running (you find it in the About Dialog, which is in the Actions/Application flap).
The categories are kmail-mobile (Mail), korganizer-mobile (Calendar and Tasks), kjots-mobile (Notes), kaddressbook-mobile (Contacts) and kdepim-mobile for issues that affect all applications.


To get the exact version, look at the About dialog in the respective application.
To get the exact version, look at the About dialog in the respective application.
Line 136: Line 123:
=== General WM 6.5 Hints ===
=== General WM 6.5 Hints ===


* None yet.
* The 'out of memory, please close a tab'- error message indicates that the system on your device indeed ran out of memory. This can happen e.g. when you try to start two applications of the Kontact Mobile. Closing one will usually free enough memory to continue working.
* If restarting your phone is not possible anymore due to rarely observed system freezes, shortly removing the battery or pressing the reset-button will bring it back.
* Ensure to be connected to the internet before starting anything of Kontact Mobile.


[[Category:Internet]]
[[Category:Internet]]

Latest revision as of 09:08, 29 October 2010

Kontact Mobile is the product name of KDE Kontact on mobile platforms. The porting is done by the KDEPIM and KDE Mobile initiatives. Kontact Mobile is also a full Kolab Groupware Client. Check out the screenshots.

There are two platform we aim at first:

Information

This page deals with Kontact Mobile for Windows Mobile. There is a separate page with information about Kontact Mobile for maemo.


Information

The project is under heavy development at the moment - but we encourage people to test and feedback upon it. Please read this page carefully.


Installation and Update

Requirements

You need approximately 120MB of free, internal memory.

Installation

We offer a cab installation archive for WM 6.5. Simply click that link on your browser and save the file on the external memory card (be sure you have good and affordable Internet access when doing so).

Afterwards, execute the downloaded file (e.g. by navigating with the File Explorer to the download location).

The Installer will ask you for an installation location, notice that in even if you chose Card, most files will be installed to internal memory (but not your data).

Beware, the installation process takes a couple of minutes and the progress bar might not indicate progress for most of the time. Be patient. If nothing changed after half an hour, restart the phone.

Generally, in case of any issues during installation/deinstallation/usage process, restart the phone.

Also, if installation succeeded, restart your phone..

Update

Currently, there is no update process. Deinstall old, install new version.

Deinstallation

Before deinstallation, restart the phone.

Then uninstall via the Settings page. Note that deinstallation takes about 10 minutes. The only feedback you will get is the spinning wheel of colored balls.

Clear the configuration

If you want to start over or remove the configuration of the KDE components completely, you need to deal with three places. First, restart your phone. Then start the File Explorer and remove following folders in "My Documents":

.config
.local
.kde

Getting started

After installation you will have find five new icons on your phone that open the mail, calendar, address book, notes and tasks frontends to Kontact-Mobile.

Touch one of these and it will start. Note that the first start of any of these applications will take a long time, as it has to spawn some stuff that works deep in the background. Expect an initial waiting time no shorter than a minute.

First thing you would want to do is to set-up a new email account. To do this you start mail, pull the flap Actions on the Homepage out, press Accounts, Add Account and then follow the instructions.

Note

You cannot do this from all frontends at the moment - but for email it works fine. If you should have an account on a Kolab Server, all applications will be able to access the data from it.


You may change the following settings, by choosing the account and use Configure Account:

  • Switch off interval sync. This might a bit too much if the initial sync has not gone through nicely (which is still possible with beta builds). You can turn it on later.
  • Switch off handling of server side subscriptions (otherwise you might not be seeing some folder you are expecting to see).
  • Enable disconnected mode for email if the number of emails you have is not that high. It mean a longer initial sync, but afterwards only changes get synced and the emails will be cached fully on the device.

Get encryption working

One of the core features of Kontact Mobile is your ability to communicate safely using S/MIME or OpenPGP. We do not provide the generation of keys on the mobile phone - you will need to set-up your keys on a computer, e.g. by using Kleopatra.

Instructions on how to transfer and use your keys on the mobile device will follow soon.

Using it: Ideas and Concepts

Navigate through your folders by our flatten tree view. You can also choose to see multiple folders at once, when you click on Select on the homepage.

Actions can be accessed through what we call flaps. You have to pull them out, in order to not mix interaction up with clicking through your accounts and folders.

We hope the other ideas are straight forward and discoverable, so we do not want to give you more hints... Give us feedback if you think we are wrong with this assumption.

Contributing / Questions and Answers / Feedback / ...

There are many ways to contribute or feedback to this project:

You discovered a defect

Please report any problems to our Bugs page, where you also might find some hot workarounds.

Use "Windows CE" as the target platform and enter komo3 as keyword to help us being fast in our response.

Note that we have created own categories for the mobile products, so please make use of that. For every problem you report, we need to know the version of Kontact Mobile you are running (you find it in the About Dialog, which is in the Actions/Application flap).

The categories are kmail-mobile (Mail), korganizer-mobile (Calendar and Tasks), kjots-mobile (Notes), kaddressbook-mobile (Contacts) and kdepim-mobile for issues that affect all applications.

To get the exact version, look at the About dialog in the respective application.

If you think that a screenshot might illustrate your problem well, consider making one and add it.

Consider doing an update before reporting a problem. The project is under heavy development and chances are good that the defect has already been fixed.

The overall stability of the packages is good. We do not expect any data loss or severe problems, as we share much of the codebase with the desktop client. But still: This product is under development, so expect to experience any kind of bugs.

You want to share your experiences?

We are accompanying the development by steady usability work. You are very welcome to participate in this process. For this, but also for less structured feedback, consider joining our mailing list.

You want to contribute to the development

For the people with a more technical view we also communicate via a mailing list.

You want to stop all KDE-PIM related processes after testing?

Restart the phone.

General WM 6.5 Hints

  • The 'out of memory, please close a tab'- error message indicates that the system on your device indeed ran out of memory. This can happen e.g. when you try to start two applications of the Kontact Mobile. Closing one will usually free enough memory to continue working.
  • If restarting your phone is not possible anymore due to rarely observed system freezes, shortly removing the battery or pressing the reset-button will bring it back.
  • Ensure to be connected to the internet before starting anything of Kontact Mobile.