react-native-malwarelytics/docs/Demo-App.md

Malwarelytics for React Native protects your banking or fintech app from a broad range of mobile security threats with an industry-leading mobile threat intelligence solution.

# Demo Application

The repository contains demo application that shows the following features:

- Initialization and Shutdown
- Listen to RASP events
- Gather all information about RASP and Antivirus modules
- Android custom Smart Protection Styling

<!-- begin box info -->
By default the application starts in offline mode because the Malwarelytics configuration has no service section configured.
<!-- end -->

## Run Demo Application

1. Clone the repository
   ```bash
   git clone https://github.com/wultra/react-native-malwarelytics.git
   ```

1. Prepare dependencies
   ```bash
   cd react-native-malwarelytics
   yarn
   cd example
   ```

1. Run Android App
   ```bash
   yarn android
   ```

1. Run iOS App
   ```bash
   yarn pods
   yarn ios
   ```

To start the Malwarelytics click `Initialize` button. Some information is displayed to debug log only (like RASP events), so check the React Native's log after the application starts. To change the configuration, open `example/src/Config.ts`. To apply the changes in config you have to click `Shutdown` and re-initialize the Malwarelytics.

If you want to configure the application for online service, then follow the next chapter.

## Configure Online Service

1. Copy environment example into `.env` file. It's expected that your currend directory is `example`:
   ```bash
   cp .env-example .env
   ```

1. Edit newly created file `.env` and update the following properties:
   - `SERVICE_APPLE_USERNAME` with your username for iOS applicatiion
   - `SERVICE_APPLE_PASSWORD` with your password for iOS application
   - `SERVICE_APPLE_PUBLIC_KEY` with your signing public key for iOS application
   - `SERVICE_ANDROID_USERNAME` with your username for Android applicatiion
   - `SERVICE_ANDROID_PASSWORD` with your password for Android application
   - `SERVICE_ANDROID_PUBLIC_KEY` with your signing public key for Android application
   
1. Make sure that each time you edit `.env` file you must run the following steps to apply the changes:
   ```bash
   yarn android
   yarn pods
   yarn ios
   yarn ios # repeat ios, to detect the changes properly
   ```

1. Update package name for Android App to match one you have registered in Malwarelytics Console:
   - Open `example/android/app/build.gradle`
   - Find and edit `applicationId "com.wultra.android.malwarelytics.reactnative.demo"`

1. Update Bundle ID for iOS App to match one you have registered in Malwarelytics Console:
   - Open `example/ios/Config.xcconfig`
   - Update `PRODUCT_BUNDLE_IDENTIFIER` property

<!-- begin box warning -->
Make sure you don't commit and push your local changes to git repository.
<!-- end -->