Skip to content

React Native Electronic-Identity-Documents reader module for Android & iOS

License

Notifications You must be signed in to change notification settings

Boukhtam/react-native-eid-reader

Repository files navigation

Contributors Forks Stargazers Issues MIT License


Logo

react-native-eid-reader

A react-native module/tool to read the contents of ISO7816 Identification/Smart cards using the NFC chip.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

About The Project

[![Product Name Screen Shot][product-screenshot]]

The module/tool currently reads the contents of:

  • Electronic/Biometric passports in BAC security mode.

  • The Algerian eID card.

    A list of commonly used resources that I find helpful are listed in the acknowledgements.

Built With

Getting Started

Prerequisites

Mostly automatic installation

  1. Within your React Native project, open up a new terminal window and install the module:
$ npm install react-native-eid-reader --save
  1. React Native requires linking native dependencies, excute the following in the terminal:
$ react-native link react-native-eid-reader

Manual installation

iOS

  1. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
  2. Go to node_modulesreact-native-eid-reader and add EidReader.xcodeproj
  3. In XCode, in the project navigator, select your project. Add libEidReader.a to your project's Build PhasesLink Binary With Libraries
  4. Run your project (Cmd+R)<

Android

  1. Open up android/app/src/main/java/[...]/MainApplication.java
  • Add import com.reactlibrary.EidReaderPackage; to the imports at the top of the file
  • Add new EidReaderPackage() to the list returned by the getPackages() method
  1. Append the following lines to android/settings.gradle:
include ':react-native-eid-reader'
project(':react-native-eid-reader').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-eid-reader/android')
  1. Insert the following lines inside the dependencies block in android/app/build.gradle:
compile project(':react-native-eid-reader')

Usage

import EidReader from 'react-native-eid-reader';

// TODO: What to do with the module?
EidReader;

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the Apache License 2.0 License. See LICENSE for more information.

Contact

Hamza BOUKHTAM - @boukhtam_hamza - [email protected]

Project Link: React Native Electronic-Identity-Documents Reader module

Acknowledgements

About

React Native Electronic-Identity-Documents reader module for Android & iOS

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published