README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43


[![Development tests](https://github.com/bitfireAT/vcard4android/actions/workflows/test-dev.yml/badge.svg)](https://github.com/bitfireAT/vcard4android/actions/workflows/test-dev.yml)
[![Documentation](https://img.shields.io/badge/documentation-kdoc-brightgreen)](https://bitfireat.github.io/vcard4android/)


# vcard4android

vcard4android is an Android library that brings together VCard and Android.
It's a framework for

* parsing and generating VCard resources (using [ez-vcard](https://github.com/mangstadt/ez-vcard))
  from/into data classes that are compatible with the Android Contacts Provider, and
* accessing the Android Contacts Provider by a unified API.

It has been primarily developed for [DAVx⁵](https://www.davx5.com) and is currently intended
to be used as git submodule.

_This software is not affiliated to, nor has it been authorized, sponsored or otherwise approved
by Google LLC. Android is a trademark of Google LLC._

Generated KDoc: https://bitfireat.github.io/vcard4android/


## Contact

```
bitfire web engineering GmbH
Florastraße 27
2540 Bad Vöslau, AUSTRIA
```

For questions, suggestions etc. use [Github discussions](https://github.com/bitfireAT/vcard4android/discussions).
We're happy about contributions! In case of bigger changes, please let us know in the discussions before.
Then make the changes in your own repository and send a pull request.


## License 

Copyright (C) Ricki Hirner (bitfire web engineering GmbH) and [contributors](https://github.com/bitfireAT/vcard4android/graphs/contributors).

This program comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome
to redistribute it under the conditions of the [GNU GPL v3](https://www.gnu.org/licenses/gpl-3.0.html).