PalmOilRipenessDetection-Python/mobile/RUN_INSTRUCTIONS.md

Running the Industrial Palm AI Mobile App

Follow these steps to start the development environment and run the app on your device or emulator.

Prerequisites

1. Node.js: Ensure you have Node.js installed (LTS recommended).
2. Android Studio: For Android development, installed with SDK and an emulator or physical device connected via ADB.
3. Xcode: For iOS development (Mac only), installed with command-line tools.
4. Dependencies: Run npm install in the mobile/ directory to ensure all packages are ready.

Quick Start

1. Start the Metro Bundler

The Metro bundler must be running for React Native to serve your JavaScript code.

cd mobile
npm start

2. Run on Android

In a new terminal window:

cd mobile
npm run android

3. Run on iOS (Mac only)

In a new terminal window:

cd mobile
npm run ios

Important Notes

• Camera Access: The app requires camera permissions. It will prompt you on first launch.
• Model Inference: The AI model is located in assets/best.tflite. It is loaded automatically on startup.
• Abnormal Alert: Detections for "Abnormal" and "Empty_Bunch" will appear with red boxes per industrial priority.

Troubleshooting

• Build Errors: If the build fails, try running npx react-native doctor inside the mobile/ folder to check your environment setup.
• Model Not Found: Ensure mobile/assets/best.tflite exists.
• Node Modules: If you encounter dependency issues, run rm -rf node_modules && npm install.