react-native-iinstall 0.2.16 → 0.2.18

package/INTEGRATION_GUIDE.md

@@ -49,20 +49,22 @@ yarn add react-native-iinstall
 Install required native peer dependencies at app root:
 
 ```bash
-npm install react-native-sensors react-native-view-shot react-native-device-info react-native-audio-recorder-player react-native-record-screen
+npm install react-native-sensors@7.3.0 react-native-view-shot@3.1.2 react-native-device-info@10.0.0 react-native-audio-recorder-player@3.6.4 react-native-record-screen@0.6.2
 ```
 
-### Updating to Latest Version (v0.2.14)
+Use `react-native-audio-recorder-player@3.6.4` unless you explicitly need v4+. Version 4.x requires `react-native-nitro-modules`.
+
+### Updating to Latest Version
 
 If you're using an older version, update to get the latest audio/video improvements:
 
 ```bash
-npm install react-native-iinstall@0.2.14
+npm install react-native-iinstall@latest
 # OR
-yarn add react-native-iinstall@0.2.14
+yarn add react-native-iinstall@latest
 ```
 
-**Key improvements in v0.2.7:**
+**Key improvements (current line):**
 - Fixed audio codec compatibility (AAC instead of ALAC)
 - Enhanced screen recording reliability
 - Improved modal state management
@@ -73,6 +75,51 @@ If you are on iOS and not using Expo Go, remember to install pods:
 cd ios && pod install
 ```
 
+### Android build compatibility (RN 0.84+ / AGP 8+)
+
+If your Android build fails due to old repositories or Kotlin/JVM targets, align your app config to Java 17:
+
+`android/build.gradle`
+```gradle
+allprojects {
+  repositories {
+    google()
+    mavenCentral()
+  }
+}
+```
+
+`android/app/build.gradle`
+```gradle
+android {
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+}
+
+kotlinOptions {
+  jvmTarget = "17"
+}
+```
+
+No `android/gradlew` script changes are needed.
+
+Temporary workaround for third-party modules that still ship incompatible Gradle files:
+
+```bash
+npm install -D patch-package
+```
+
+`package.json`
+```json
+{
+  "scripts": {
+    "postinstall": "patch-package"
+  }
+}
+```
+
 ---
 
 ## 4. Configure the SDK
@@ -108,6 +155,12 @@ If you pass `pushToken`, SDK auto-registers it to the backend using:
 
 `POST /api/notifications/push/register`
 
+If you use React Native Firebase to get the token, install:
+
+```bash
+npm install @react-native-firebase/app @react-native-firebase/messaging
+```
+
 ```tsx
 import React from 'react';
 import messaging from '@react-native-firebase/messaging';
@@ -140,11 +193,11 @@ import { registerPushToken, unregisterPushToken } from 'react-native-iinstall';
 
 ---
 
-## 6. Audio & Video Feedback (v0.2.14+)
+## 6. Audio & Video Feedback (recommended on v0.2.18+)
 
 The SDK now supports **Audio Feedback** (Voice Notes) and **Screen Recording** with enhanced compatibility and reliability.
 
-### Key Improvements in v0.2.7
+### Key Improvements
 
 1. **Audio Codec Fix**: Audio recordings now use AAC codec instead of ALAC, ensuring compatibility with dashboard audio players
 2. **Modal State Management**: Improved handling of audio state to prevent stale data between feedback sessions
@@ -155,7 +208,7 @@ The SDK now supports **Audio Feedback** (Voice Notes) and **Screen Recording** w
 These features require native modules. If you haven't already, run:
 
 ```bash
-npm install react-native-sensors react-native-view-shot react-native-device-info react-native-audio-recorder-player react-native-record-screen
+npm install react-native-sensors@7.3.0 react-native-view-shot@3.1.2 react-native-device-info@10.0.0 react-native-audio-recorder-player@3.6.4 react-native-record-screen@0.6.2
 cd ios && pod install
 ```
 
@@ -224,7 +277,7 @@ A: The app will work fine, but features like "Shake to Report" and automatic ses
 A: Ensure your project icon URL is valid. If the image fails to load, the dashboard now automatically falls back to showing the project's initial letter on a styled background.
 
 **Q: Audio feedback shows 0:00 duration in dashboard?**
-A: Update to SDK v0.2.14+ which includes the audio codec compatibility fixes. Audio files are encoded as AAC for browser playback.
+A: Update to SDK v0.2.18+ and rebuild after installing the pinned peer dependencies. Audio files are encoded as AAC for browser playback.
 
 **Q: Screen recording sometimes doesn't capture?**
-A: Update to SDK v0.2.14+ which includes enhanced URI extraction and better error handling for screen recordings across different devices.
+A: Update to SDK v0.2.18+ which includes enhanced URI extraction and better error handling for screen recordings across different devices.

package/README.md

@@ -36,14 +36,62 @@ Transform your app's feedback collection with our powerful shake-to-report SDK.
 
 2. Install required native peer dependencies in your app root:
    ```bash
-   npm install react-native-sensors react-native-view-shot react-native-device-info react-native-audio-recorder-player react-native-record-screen
+   npm install react-native-sensors@7.3.0 react-native-view-shot@3.1.2 react-native-device-info@10.0.0 react-native-audio-recorder-player@3.6.4 react-native-record-screen@0.6.2
    ```
 
+   We recommend `react-native-audio-recorder-player@3.6.4`. If you install v4+, you must also install `react-native-nitro-modules`.
+
 3. Link native modules (iOS only, non-Expo):
    ```bash
    cd ios && pod install
    ```
 
+## Android Build Compatibility (RN 0.84+)
+
+If your app is on React Native 0.84+ / modern Android Gradle Plugin, use JDK 17 and modern repositories.
+
+`android/build.gradle`:
+
+```gradle
+allprojects {
+  repositories {
+    google()
+    mavenCentral()
+  }
+}
+```
+
+`android/app/build.gradle`:
+
+```gradle
+android {
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+}
+
+kotlinOptions {
+  jvmTarget = "17"
+}
+```
+
+No `android/gradlew` script changes are required.
+
+Temporary fallback when third-party modules still ship old Gradle/Kotlin config:
+
+```bash
+npm install -D patch-package
+```
+
+```json
+{
+  "scripts": {
+    "postinstall": "patch-package"
+  }
+}
+```
+
 ## Usage
 
 Wrap your main app component with the `<IInstall>` provider.
@@ -52,24 +100,13 @@ Wrap your main app component with the `<IInstall>` provider.
 import React from 'react';
 import { IInstall } from 'react-native-iinstall';
 import AppNavigation from './src/AppNavigation';
-import messaging from '@react-native-firebase/messaging';
 
 const App = () => {
-  const [pushToken, setPushToken] = React.useState<string>();
-
-  React.useEffect(() => {
-    messaging()
-      .getToken()
-      .then(setPushToken)
-      .catch(() => undefined);
-  }, []);
-
   return (
     // Get your API Key from the IInstall Dashboard (Project Settings)
     <IInstall 
       apiKey="YOUR_PROJECT_API_KEY" 
       apiEndpoint="https://iinstall.app" // Optional, defaults to production
-      pushToken={pushToken} // Optional: auto-registers token to iinstall backend
       enabled={__DEV__} // Optional: Only enable in dev/test builds
     >
       <AppNavigation />
@@ -80,6 +117,26 @@ const App = () => {
 export default App;
 ```
 
+Optional push token (React Native Firebase):
+
+```bash
+npm install @react-native-firebase/app @react-native-firebase/messaging
+```
+
+```tsx
+import messaging from '@react-native-firebase/messaging';
+
+const pushToken = await messaging().getToken();
+
+<IInstall
+  apiKey="YOUR_PROJECT_API_KEY"
+  apiEndpoint="https://iinstall.app"
+  pushToken={pushToken}
+>
+  <AppNavigation />
+</IInstall>
+```
+
 ## 🚀 Perfect For
 
 - **Beta Testing Programs** - Collect rich feedback from beta testers
@@ -176,8 +233,10 @@ await unregisterPushToken({
 - **Shake not working?** Test on real device or enable "Shake" in simulator
 - **Network errors?** Verify `apiEndpoint` is base URL only (not `/api/sdk/issue`)
 - **Permissions denied?** Check platform-specific setup in integration guide
-- **Audio issues?** Ensure SDK v0.2.14+ and rebuild after native peer install
+- **Audio issues?** Ensure SDK v0.2.18+ and rebuild after native peer install
 - **Native module is null/undefined?** Reinstall peer deps in app root, run `cd ios && pod install`, then rebuild the app
+- **Android error `Project with path ':react-native-nitro-modules' could not be found`?** Downgrade to `react-native-audio-recorder-player@3.6.4` (or install `react-native-nitro-modules` when using audio-recorder-player v4+)
+- **Android build fails on `jcenter()` or Kotlin JVM target mismatch?** Use `mavenCentral()` and set Java/Kotlin target to `17`; if dependency scripts are old, patch with `patch-package`
 
 ### Getting Help
 - 📖 [Complete Integration Guide](INTEGRATION_GUIDE.md)

package/RELEASE_MANIFEST.json

@@ -1,8 +1,8 @@
 {
-  "version": "0.2.16",
+  "version": "0.2.18",
   "highlights": [
-    "Native modules now declared as peer dependencies for reliable app-root autolinking",
-    "SDK now lazy-loads native modules and degrades gracefully instead of hard crashing",
-    "Updated integration docs with explicit peer dependency install commands"
+    "Pinned native peer install guidance to avoid Android dependency drift",
+    "Added RN 0.84+ compatibility notes (JDK 17, mavenCentral, Kotlin JVM target 17)",
+    "Documented patch-package fallback for incompatible third-party native modules"
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iinstall",
-  "version": "0.2.16",
+  "version": "0.2.18",
   "description": "🎯 IInstall React Native SDK - The ultimate beta testing & QA feedback tool. Shake-to-report with voice recordings, screen recordings, and screenshots. Zero-config setup with TypeScript support. Perfect for beta testing, QA teams, and user feedback collection.",
   "author": "TesterFlow Team",
   "license": "MIT",
@@ -49,7 +49,7 @@
   "peerDependencies": {
     "react": ">=16.8.0",
     "react-native": ">=0.60.0",
-    "react-native-audio-recorder-player": "^3.6.4",
+    "react-native-audio-recorder-player": ">=3.6.4 <4",
     "react-native-device-info": "^10.0.0",
     "react-native-record-screen": "^0.6.2",
     "react-native-sensors": "^7.3.0",