@azerion/bluestack-sdk-react-native

BlueStack SDK - React Native

Introduction

React Native BlueStack SDK [@azerion/bluestack-sdk-react-native] allows you to monetize your app with BlueStack; It's a wrapper that provides functionality to integrate native BlueStack SDK into React Native project for both iOS and Android.

The module supports four types of Ads:

• Component based Banner Ads.
• Full screen Interstitial Ads.
• Full screen Rewarded Ads.

Prerequisites

• React Native 0.80 or higher
  • Supports React Native New Architecture (Fabric/TurboModules)
• Node.js 18 or higher
• TypeScript support (project is written in TypeScript)
• Android
  • Target Android API level 21 or higher
  • Java Development Kit (JDK) 17 or higher
  • Android Build Tools 35.0.0 or compatible
  • AndroidX support
• iOS
  • iOS 12.2 or higher
  • Xcode 14.0 or higher (for React Native 0.80+ support)
  • CocoaPods for dependency management

Setting up environment

To work with this project, you'll need to set up your development environment with the necessary tools and dependencies. Here’s a comprehensive list of the prerequisites:

1. Node.js and npm (or Yarn)

• Node.js: JavaScript runtime built on Chrome's V8 JavaScript engine.
• npm: Node package manager, which comes with Node.js.
• Yarn (optional): Alternative package manager.

You can download and install Node.js from nodejs.org.

To verify the installation:

node -v
npm -v

To install Yarn (optional):

npm install -g yarn

2. Watchman (macOS Only)

Watchman is a tool by Facebook for watching changes in the filesystem. It's highly recommended on macOS to improve performance.

brew install watchman

3. React Native CLI

React Native CLI is the command-line interface for React Native. Install it globally using npm or Yarn:

npm install -g @react-native-community/cli

or

yarn global add @react-native-community/cli

4. TypeScript

This project is written in TypeScript. While TypeScript will be installed as a dependency when you install the SDK, you may want to install it globally for better development experience:

npm install -g typescript

or

yarn global add typescript

To verify the installation:

tsc --version

5. Java Development Kit (JDK)

For Android development, you'll need Java Development Kit (JDK) 17 or higher. You can install it from:

• Oracle JDK
• OpenJDK (recommended)
• Amazon Corretto

To verify the installation:

javac -version
java -version

Make sure both commands show version 17 or higher.

6. Android Studio

Android Studio provides the Android SDK and other necessary tools for Android development.

• Download and install Android Studio.

• During installation, ensure you install the following components:

  • Android SDK
  • Android SDK Platform
  • Android Virtual Device (AVD)

• Configure the environment variables:

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools

7. Xcode (macOS Only)

For iOS development, you need Xcode 14.0 or higher for React Native 0.80+ support.

• Download and install Xcode from the Mac App Store.
• Install Xcode Command Line Tools:

xcode-select --install

• Open Xcode and install any additional required components.

8. CocoaPods (iOS Only)

CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects. It's used in React Native for handling native iOS dependencies.

Install CocoaPods using Ruby gem:

sudo gem install cocoapods

Setting Up the React Native Bluestack module

Once you have all the prerequisites installed, you can set up the Bluestack module in your React Native project:

npm install @azerion/bluestack-sdk-react-native

Usage

• SDK Integration
• Displaying Ads