Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/capacitor-community/contacts

Contacts Plugin for Capacitor
https://github.com/capacitor-community/contacts

Last synced: 5 days ago
JSON representation

Contacts Plugin for Capacitor

Awesome Lists containing this project

README

        



Contacts

@capacitor-community/contacts

Capacitor Plugin for accessing Contacts.















## Purpose

This plugin enables you to access the native contacts APIs of iOS and Android. It allows you to retrieve, create and delete contacts.

## Versions

Currently there are three actively maintained versions of this plugin. The API of these versions is identical. The only difference between these versions is the supported Capacitor versions.

| Plugin | Capacitor | Status | Documentation |
| ------ | --------- | ------ | ------------------------------------------------------- |
| v6.x | v6.x | LTS | [Link](https://capacitor-community.github.io/contacts/) |
| v5.x | v5.x | LTS | [Link](https://capacitor-community.github.io/contacts/) |
| v4.x | v4.x | LTS | [Link](https://capacitor-community.github.io/contacts/) |
| v3.x | v3.x | LTS | [Link](https://capacitor-community.github.io/contacts/) |

If you are installing this plugin into a new project, you can ignore the following explanation.

In the past a few other versions of this plugin were released, also targeting different versions of Capacitor:

| Plugin | Capacitor | Status | Documentation |
| ------------- | --------- | ---------- | --------------------------------------------------------------------------------------------------------------- |
| v2.x | v4.x | Deprecated | [Link](https://github.com/capacitor-community/contacts/blob/v2.0.0/README.md) |
| v1.0.9 and up | v3.x | Deprecated | [Link](https://github.com/capacitor-community/contacts/blob/1.1.3/README.md) |
| v1.0.0 and up | v2.x | Deprecated | [Link](https://github.com/capacitor-community/contacts/blob/0cb99be68dc8ee4547c75f932872bd065f5509d2/README.md) |
| v0.x | v2.x | Deprecated | [Link](https://github.com/capacitor-community/contacts/blob/0.1.1/README.md) |

Admittedly, this wasn't the most consistent versioning strategy, and we'll keep it more coherent in the future.

It's highly recommended to upgrade to either v3, v4, v5 or v6 if you are using an old version!

## Documentation

Extensive documentation is available [here](https://capacitor-community.github.io/contacts/).

## Shortcuts

- [Documentation homepage](https://capacitor-community.github.io/contacts/)

- [Installation](https://capacitor-community.github.io/contacts/#/getting-started-installation)

- [API reference](https://capacitor-community.github.io/contacts/#/api)

## Limitations

This plugins only adds support for using the native iOS and Android APIs. If you want to make use of the JavaScript API as well (for a possible webapp) you should implement that separately. Of course it should be possible to integrate this into the plugin in the future. If you want to help out with this, please start a PR.