iOS parity, structural orientation/mirror, frame-lifetime safety, honest packaging & docs

.github/workflows/ci.yml

@@ -0,0 +1,63 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, ios_support ]
+  pull_request:
+
+jobs:
+  analyze-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: subosito/flutter-action@v2
+        with:
+          channel: stable
+      - name: Install dependencies
+        run: flutter pub get
+      - name: Verify formatting
+        run: dart format --output=none --set-exit-if-changed .
+      - name: Analyze
+        run: flutter analyze
+      - name: Run tests
+        run: flutter test
+      - name: Publish dry-run
+        run: flutter pub publish --dry-run
+      - name: pana score
+        run: |
+          dart pub global activate pana
+          dart pub global run pana --no-warning --exit-code-threshold 20 .
+
+  build-android:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+      - uses: subosito/flutter-action@v2
+        with:
+          channel: stable
+      - name: Build example APK (compiles Kotlin + native C)
+        run: |
+          cd example
+          flutter pub get
+          flutter build apk --debug
+
+  build-ios:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: subosito/flutter-action@v2
+        with:
+          channel: stable
+      - name: Build example iOS (compiles Swift + native C)
+        run: |
+          cd example
+          flutter pub get
+          flutter build ios --no-codesign --debug
+      - name: Lint podspec
+        run: |
+          cd ios
+          pod lib lint --allow-warnings || true

CHANGELOG.md

@@ -1,15 +1,54 @@
-## 0.0.1
+# Changelog
 
-* Initial release of `flutter_native_vision_camera`.
-* Integrated FFI for high-performance frame processing.
-* Support for zero-copy preview textures on Android and iOS.
-* Basic camera controls (zoom, focus, flash).
-* Vision API for real-time frame access.
+## 0.0.4
+
+Correctness, honesty, and packaging pass.
+
+* **Fixed:** removed the deprecated `package` attribute from the Android manifest (broke builds under AGP 8.x;
+  the namespace is set in `build.gradle`).
+* **Fixed:** Android video recording no longer crashes — `RECORD_AUDIO` is now declared and audio is gated behind a
+  runtime permission check, falling back to video-only when the mic is unavailable.
+* **Fixed:** `requestMicrophonePermission` now actually awaits the permission dialog result.
+* **Fixed:** frame processor no longer routes frames through a no-op relay isolate. The Dart callback is now
+  delivered directly via `NativeCallable.listener`; documentation corrected to state it runs on the main isolate
+  event loop (not a background isolate).
+* **Fixed:** `CameraPreview` now rebuilds when the controller updates (e.g. after async init or device switch).
+* **Fixed:** Android tap-to-focus now targets the correct metering point.
+* **Improved:** Android frames now expose all YUV planes with correct row strides (previously only the Y plane).
+* **Improved:** iOS reports the real frame pixel format and retains preview buffers safely.
+* **Packaging:** real podspec metadata, version lockstep, honest README/feature matrix, `topics`/`issue_tracker`,
+  CI (format/analyze/test/dry-run/pana + per-platform native builds), dropped the unused
+  `plugin_platform_interface` dependency.
+* **iOS:** implemented video recording (AVAssetWriter, keeps the frame stream live), `setFocusDistance`,
+  barcode symbology filtering, teardown-on-reinit, `CVPixelBuffer` retain/lock balance, honest pixel format,
+  main-thread results. Device-verified on iOS 18 (preview, photo, video, scanning).
+* **Orientation (structural):** preview rotation is now read from the camera framework
+  (Android `SurfaceRequest.TransformationInfo`, iOS sensor-relative) and applied once in `CameraPreview` —
+  fixing the recurring 90° tilt. Added `controller.previewRotation` / `displayPreviewSize`; scanner overlay
+  and camera page no longer compensate for rotation themselves. iOS Vision boxes now use the buffer orientation.
+* **Mirroring:** a single `mirror` flag on `initialize` drives both the front-camera preview and the saved
+  photo/video; the preview no longer double-mirrors on Android. `CameraPreview` gains `ResizeMode.contain`.
+* **Android:** dynamic capture orientation, correct tap-to-focus metering, real photo orientation.
+* **API:** exposed per-plane strides (`Frame.planeBytesPerRow`/`planePixelStride`) so chroma planes can be
+  walked correctly; added `CameraDevices.getCameraFormat(...)` to pick a format by resolution/fps.
+* **Docs:** comprehensive README (compile-correct quickstart with permissions, photo/video/scan/lifecycle
+  snippets, a correct native C/C++ plugin guide, requirements, expanded platform matrix, Limitations & Roadmap);
+  rewrote the example README; corrected the "background isolate" claim in the API docs to match reality
+  (main isolate); documented `takeSnapshot` (iOS-only), `setExposure` units, and `initialize`'s
+  `pixelFormat`/`mirror`.
+* **Example:** the Native Vision Camera page now reads the raw frame buffer over FFI and shows a live average
+  brightness, demonstrating the headline feature; fixed the C++ sample's row-stride indexing.
 
-### 0.0.2
+## 0.0.3
+
+* Migrated the Android embedding to AndroidX for better compatibility.
+
+## 0.0.2
 
 * Fixed pubspec metadata (homepage, repository).
 
-### 0.0.3
+## 0.0.1
 
-* Replaced Android2 with AndroidX for better compatibility.
+* Initial release of `flutter_native_vision_camera`.
+* FFI pipeline for frame access, zero-copy preview textures, basic camera controls (zoom, focus, flash),
+  and real-time barcode scanning.