Skip to content

Latest commit

 

History

History

README.md

Welcome to the Expo AEPSample App with New Architecture Enabled

Table of Contents

Introduction

Welcome to the Expo AEPSample App with New Architecture Enabled. This project is an Expo app created using create-expo-app. It demonstrates the integration of Adobe SDKs with a React Native app using Expo, with the new architecture enabled by default.

Prerequisites

Before running the example app, ensure your environment meets the following requirements. These prerequisites are specific to the example app:

Installation

To install AEPSampleAppNewArchEnabled App, follow these steps:

Install dependencies

Note: Commands are assuming you're in the root directory of the repository.

yarn install 

Build packages

yarn run build

Generate Native Projects

yarn sampleappnewarchenabled:expo:prebuild

Get Started

Add your App Id:

In apps/AEPSampleAppNewArchEnabled/app/_layout.tsx, locate the call to MobileCore.initializeWithAppId(appId:"YOUR_APP_ID") and replace "YOUR_APP_ID" with your property App Id.

Note: The App ID should be configured in a mobile property in the Data Collection UI, in Tags. Refer to Adobe documentation for more information.

Run Instructions

Run Instructions for iOS

  1. Run Using Yarn
    Ensure you are in the root directory of the project and execute the following command:

    yarn sampleappnewarchenabled:ios:run
  2. Run the iOS App from Xcode
    Alternatively, follow these steps to run the app using Xcode:

    • Start the Expo server by running the following command in the terminal:
      cd apps/AEPSampleAppNewArchEnabled
      npx expo start
    • Navigate to the iOS directory:
      cd ios
    • Open the Xcode workspace:
      open AEPSampleAppNewArchEnabled.xcworkspace
    • Once Xcode opens, build and run the app on your desired simulator or device.

Run Instructions for Android

  1. Run Using Yarn
    Ensure an Android emulator is running or a physical device is connected. For guidance, refer to the Android Emulator Command Line Documentation. Then, execute the following command from the root directory:

    yarn sampleappnewarchenabled:android:run
  2. Run the Android App from Android Studio
    Alternatively, follow these steps to run the app using Android Studio:

    • Start the Expo server by running the following command in the terminal:
      cd apps/AEPSampleAppNewArchEnabled
      npx expo start
    • Navigate to the android directory:
      cd android
    • Open the project in Android Studio by launching build.gradle located in the apps/AEPSampleAppNewArchEnabled/android directory.
    • Once Android Studio opens, build and run the app on your connected device or emulator.

Validate with Assurance

Assurance is integrated into the sample app for event and flow validation.

  1. Create an Assurance Session.
  2. Copy the session link from the Copy Link button in the Assurance Session Details window.
  3. Paste the link into the AEPSampleAppNewArchEnabled -> AssuranceView and start the session.

Thank you for using Expo AEPSample App with New Architecture Enabled! Feel free to star this repository and provide feedback!