Nuclear Pumpkin Mayhem

    @tuofeng/react-native-contacts-wrapper

    0.2.9 • Public • Published

    react-native-contacts-wrapper

    alt tag

    This is a simple wrapper for the native iOS and Android Contact Picker UIs. When calling the API functions, the appropriate picker is launched. If a contact is picked, the promise is resolved with the requested data about the picked contact.

    This uses the ContactsContract API for Android, AddressBook library for iOS8 and below and the new Contacts library for ios9+.

    The API is currently very basic. This was started just as a way of selecting a contact's email address. The getContact function was added as a more generic way of returning contact data. Currently this returns Name, Phone and Email for picked contact. In future more fields will be added to this, and possibly more specific methods similar to getEmail.

    Feel free to extend the functionality so it's more useful for everyone - all PRs welcome!

    Installation

    Automatic (works for iOS without condition; for Android with RN 0.28 and before)

    If you have rnpm installed, all you need to do is

    npm install react-native-contacts-wrapper --save
    rnpm link react-native-contacts-wrapper
    

    Manual

    Android (with RN 0.29 and above)

    in settings.gradle

    include ':react-native-contacts-wrapper'
    project(':react-native-contacts-wrapper').projectDir = new File(settingsDir, '../node_modules/react-native-contacts-wrapper/android/app')
    

    in android/app/build.gradle

    dependencies {
        compile project(':react-native-contacts-wrapper')
    

    in MainApplication.java add package to getPacakges()

    import com.lynxit.contactswrapper.ContactsWrapperPackage;
    ...
    
    @Override
    protected List<ReactPackage> getPackages() {
        return Arrays.<ReactPackage>asList(
            new MainReactPackage(),
            ...,
           new ContactsWrapperPackage()
       );
    }
    

    in AndroidManifest.xml make sure you have the following setting even if you have done react-native upgrade

    <application
         android:name=".MainApplication"
    
    

    Also add

    <uses-permission android:name="android.permission.READ_CONTACTS" />
    

    iOS

    1. Open your xCode project
    2. Click project name in project navigator
    3. Select the main target in the left hand menu
    4. Scroll to Linked Frameworks and Libraries
    5. click + at bottom
    6. Click ‘Add Other'
    7. Find and add your new project’s .xcodeproj file from node_modules
    8. This will now appear in project explorer, drag in under the Libraries group.
    9. In same screen, click + again, you should now see the .a file for you project, Add this
    10. Clean and Rebuild your Xcode project

    Also if you have cocoaPods,just cd ios/ && pod install.

    ##API

    getContact (Promise) - returns basic contact data as a JS object. Currently returns name, first phone number and first email for contact. getEmail (Promise) - returns first email address (if found) for contact as string.

    ##Usage

    Methods should be called from React Native as any other promise. Prevent methods from being called multiple times (on Android).

    ###Example

    An example project can be found in this repo: https://github.com/LynxITDigital/react-native-contacts-wrapper-example/tree/master

    import ContactsWrapper from 'react-native-contacts-wrapper';
    ...
    if (!this.importingContactInfo) {
      this.importingContactInfo = true;
    
      ContactsWrapper.getEmail()
      .then((email) => {
        this.importingContactInfo = false;
        console.log("email is", email);
        })
        .catch((error) => {
          this.importingContactInfo = false;
          console.log("ERROR CODE: ", error.code);
          console.log("ERROR MESSAGE: ", error.message);
          });
    

    Install

    npm i @tuofeng/react-native-contacts-wrapper

    DownloadsWeekly Downloads

    3

    Version

    0.2.9

    License

    MIT

    Unpacked Size

    83 kB

    Total Files

    23

    Last publish

    Collaborators

    • iwater