NativePHP changelog

• Patches Axios for iOS (precognition changes)

• Fixes Share.Url for Android

• Reverts iOS Safari debug ability

• Fixe PushNotifications::getToken()

Add cross-platform Camera PermissionDenied event

What's Changed

Camera Permission Handling

• iOS: Added explicit permission checking before accessing camera for photos and videos
• Android: Now dispatches PermissionDenied event when camera permission is denied, matching iOS behavior

Event payload:

• action: "photo" or "video"
• id: optional tracking ID

What's Changed

Include dev dependencies in Android debug builds

Android debug builds now match iOS behavior by including dev dependencies (like fakerphp, sail, pint) in the bundle.

• Debug builds (native:run): runs composer install without --no-dev, including dev dependencies
• Release/package builds (native:run --build=release, native:package): runs composer install --no-dev, excluding dev dependencies

This allows packages that use dev dependencies (like factories with Faker) to work correctly during local development.

• Renames Android package from com.example.androidphp to com.nativephp.mobile
• Fixes namespace/applicationId architecture - namespace stays fixed for JNI bindings, only applicationId changes per app
• Reorganizes code structure (QrCodeScannerActivity → ui package)

Summary

This release includes significant improvements to EDGE components, installation experience, and build tooling.

EDGE Components

Required Props Validation

• Added MissingRequiredPropsException with clear error messages when EDGE components are missing required attributes
• Validates required props on BottomNavItem, SideNavItem, TopBarAction, Fab, SideNavGroup, TopBar

Font-Based Icon Rendering

• Replaced 30MB material-icons-extended library with 348KB font file
• Uses font ligatures for efficient icon rendering
• iOS: Supports direct SF Symbol paths (e.g., car.side.fill)
• Maintains alias mapping for cross-platform friendly names

Installation

Auto-Prompt for App ID

• native:install now prompts for NATIVEPHP_APP_ID if not already set
• Auto-generates suggested bundle ID using format com.{username}.{randomwords}

Build & Packaging

Improved iOS Build Logging

• Standardized console output using twoColumnDetail() format for App Store Connect operations
• Replaced emoji-prefixed logs with consistent Laravel Prompts styling
• Elaborate error diagnostics with pattern matching for common Xcode build errors
• Specific actionable solutions for:
  • Certificate/provisioning profile mismatches
  • Expired provisioning profiles
  • Missing signing certificates
  • Code signing errors
• Shows last 30 lines of error output when builds fail
• Displays build log path for debugging

Other Improvements

• Better handling of false positives from Apple during upload
• Build log paths use note() for consistent styling

• exports the bridgeCall js method
• updates aspect ratio for Android icons

• Foreground permissions: Prevent removal of FOREGROUND_SERVICE and POST_NOTIFICATIONS permissions when they're needed by camera features, even if push notifications are disabled
• Symlink fix: Run storage:unlink before storage:link to handle stale symlinks, and exclude public/storage from build to prevent symlink conflicts
• iOS Push Notifications
• Fix Missing $id param on some events

• Fixed Scanner permissions
• Fixed Android edge-to-edge
• Fixed Browser::auth on iOS
• iOS: Fix text alignment in native top-bar component
• Android: Support custom deep links/app links scheme etc
• iOS: Fix plist issues
• Fix NATIVEPHP_START_URL
• native:install: Add --fresh and -F, aliases of --force
• native:install: Timeout increase for slower networks
• Support common URL schemes tel:, mailto:, sms:, geo:, facetime:, facetime-audio:
• Remove all EDGE components with Edge::clear()
• System::appSettings() to go to your app's settings screen in the OS Settings app
• Add Native.shareUrl() to JS library
• Combined watcher
• Switch from fswatch to Watchman
• Blade directives @mobile, @web, @android, @ios
• Improved Windows support
• Android: Fix camera cancelled events
• Cleaner console output
• Fix: Allow bottom-nav values to change dynamically

• Post-v2 fixes

🍑

Full Changelog: https://nativephp.com/docs/mobile/2/getting-started/changelog

What's Changed

• Add edge-to-edge UI support for Android 15+
• Inset support on iOS
• Other iOS web view improvements
• Improved facades and method names

• Updates Android event namespacing bug

• adds HMR for Android

• adds support for browser sniffing

• fixes typo

No description available for this release.

• adds Device Info API

• small fix for ios

• Adds ability to constrain orientation for iOS and Android.
• If all orientation config values are set to false for a device it will deactivate support for that device.
• Updates support for Android icons, previously Android icons were rendered and skewed differently than iOS leading to a mismatch between devices. This attempts to resolve that.

• updates p12 generation for gdpr compliance

• adds skippable packaging

• updates min sdk version for Android

• temporarily disables post update hook

• updates signing and entitlement provisioning

• updates nfc permissions on iOS

• adds better support for iOS permissions

• fixes escaping shell args for passwords with special characters in the package command
• removes unnecessary app deletion step for iOS simulator builds
• honors exclusion dirs for Android builds

• resolves conflict

• Includes completely recompiled PHP binaries against the Android Native Development Kit (NDK) v27 (previous v25) with support for 16kb page sizes. This is a requirement from the Google Play Store and ensures forward compatibility for Play Store distribution (sunsetting support November 1, 2025).
• New native:version command to quickly display which NativePHP version is installed
• Better iOS local support, previously one would have to manually uninstall their app each time they redeployed to a simulator or their physical device with the native:run command. This step is handled automatically for the developer.
• Removes manual handling of keyboard insets for Android

• removes manual inset handling for keyboard

• migrated dependencies in build.gradle.kts to use version catalog (libs) references and updated library versions in libs.versions.toml.
• enabled bundle splits for ABI, language, and density, and added Kotlin compiler and API check suppressions.
• improved theme with transparent system bars and disabled contrast enforcement.
• suppressed deprecation warnings in PHPBridge.kt.

• adds native:tail (Android only for now) tail your laravel.log file!

• fixes improper import

• Adds support for foregrounded Firebase notifications on iOS
• Fixes aps entitlement bug

• Added notification channel creation and foreground notification display in PushNotificationService. Improved logging and refactored notification handling for better user experience. Also updated google-services Gradle plugin to version 4.4.3.

• updates android splash screen logic

• updates permissions conflicts

• adds better config support for default Android permissions
• adds overriding the config with a native:install --force

• Add autoloader regeneration after production dependency install in PreparesBuild.php to prevent dev dependency references in bundle.

• ensures build numbers don't increase by more than 1

• adds ability to package iOS apps using flags vs env vars
• backward compatible

• adds a jump-by for stuck builds (Android)

• updates Android packaging build number revision checking

• Adds 10 to build number for each push to Play Store

• adds ability to check Google Play Store for latest build number and auto increment for packaging

• adds ability to reset jks for Play Store
• Adds Play Store submission ability

• updates Build command

• fixes for iOS packaging

Adds support for iOS packaging

Windows Installation Fix

Fixed: Windows installation failures with PHP 8.4 due to missing ZipArchive extension.

What changed:

• Windows now uses 7-Zip for ZIP extraction during php artisan native:install
• Linux/macOS behavior unchanged
• Better error messages if 7-Zip not found

Impact: Resolves "Class ZipArchive not found" errors on Windows systems where the PHP ZIP extension isn't available by default.

🔐 New Features

• Credentials Command: Generate Android keystores and iOS certificates with native:credentials
• Fullscreen Videos: Android WebView now supports fullscreen video playback

🛠️ Improvements

• Interactive credential generation with secure defaults
• Automatic landscape orientation for fullscreen content
• Enhanced WebView media playback capabilities

 Enables automated iOS app packaging in CI environments without Xcode login requirements.

Key Features:

• Manual signing with environment variables for CI/CD
• Apple certificate chain validation fixes
• Swift Package Manager compatibility improvements
• Automatic provisioning profile handling

Environment Variables:

• IOS_CERTIFICATE_P12_BASE64 - Base64 iOS certificate
• IOS_PROVISIONING_PROFILE_BASE64 - Base64 provisioning profile
• NATIVEPHP_DEVELOPMENT_TEAM - Apple Developer Team ID
• IOS_CERTIFICATE_PASSWORD - Certificate password

Now supports fully automated php artisan native:package ios --export-method=app-store in headless environments.

🤖  Introduces a 'location' option to the nativephp config 🤖 Sets NATIVEPHP_PLATFORM to 'android' in the LaravelEnvironment class.

These changes improve platform-specific configuration and feature toggling.

What's Changed

• 📱 Implement packaging for iOS - this builds, archives and validates the archive
• 📱 Improves native:watch
• 📱 Fixes an issue with web view interrupted requests crashing the app
• 📱 Adds onig and mbregex support (enabling mb_split and other multibyte string functions)
• 🤖 Check for google-services.json in nativephp/resources/

Run composer update then php artisan native:install ios --force to get the latest changes.

Fixed: Android builds on macOS no longer include unnecessary iOS files, reducing bundle size and improving build consistency.

What's Changed

• 📱 Inertia is now working on iOS. Run native:patch-inertia. More details in the docs

What's New

• 📱 Drastically improved hot-reloading on iOS! There's a new native:watch command that you can attach to any running simulator and you don't need to do the quirky Cmd+Ctrl+Z keybind and manually refresh - full auto-refreshing is included as standard (requires fswatch to be installed)
• 📱 Fixed copying the GoogleService-Info.plist into place if it can be found
• 📱 Fixed some .env file manipulation snafus
• 📱 Improved iOS migration and cache clearance timing for even faster startups
• 📱 Removed npm commands from the iOS build process - you will need to run your frontend build commands before running native:run, just like Android
• 🧹 Package cleanup

To get this update, run composer update and then php artisan native:install --force

What's New

• Now running PHP 8.4.10
• Reduced PHP binary sizes across both Android and iOS by > 50%
• All new APIs: Browser, Geolocation, SecureStorage, Media Library (aka Photos/Camera Roll)
• Refactored APIs for better namespacing

Other improvements

• 📱🤖 Alert: Removed callback, made buttons optional
• 📱 Massive build process improvements - faster builds, smaller and faster apps
• 📱 Various fixes across alerts, push notifications and more
• 🤖 Add independent Android minification and obfuscation control
• 🤖 Handle keyboard insets for WebView in MainActivity
• 🤖 Remove redundant Artisan calls
• 🤖 Update MainActivity configChanges in AndroidManifest
• 🤖 Update Android dependencies
• 🤖 Improved camera handling

To get this update, run composer update and then php artisan native:install --force

• adds edge-to-edge support for Android 15+

Pre v1.1 release to test internal tooling

• patch moves build to package

NativePHP Mobile v1.0.17 - Signed Build Support & Enhanced CI/CD

🚀 Major Features

Signed Android Build Support

• Added comprehensive signed build capabilities with native:build command
• Support for both APK and AAB (Android App Bundle) signed releases
• Keystore management with environment variable and command-line options
• Automatic build verification to ensure proper signing

Enhanced GitHub Actions Workflow

• Comprehensive CI/CD pipeline testing package installation and builds
• Tests both unsigned development builds and signed production builds
• Artifact collection for debugging and distribution
• Performance optimizations with intelligent caching (PHP, Composer, Laravel, Gradle)

🔧 Improvements

Build Process Enhancements

• Fixed infinite recursion issues in file operations during bundle creation
• Improved cross-platform file handling (Windows, macOS, Linux)
• Enhanced Laravel bundle ZIP creation with better error handling
• Updated Android targetSdk to 35 for latest compatibility

Developer Experience

• Comprehensive build environment validation
• Better error messages and debugging information
• Streamlined workflow that runs only on pull requests
• Conservative Gradle dependency caching to reduce build times

🐛 Bug Fixes

• Corrected APK signing configuration in build templates
• Fixed GitHub Actions workflow syntax for secrets handling

📦 Package Management

• Updated composer dependencies and lock file
• Improved package structure and organization

🛠️ Technical Details

New Commands:

• native:build - Build signed Android/iOS apps for distribution with comprehensive options for keystore management

Enhanced Traits:

• Improved PlatformFileOperations with better cross-platform support
• Enhanced PreparesBuild with robust ZIP creation and validation

CI/CD Features:

• Multi-stage testing (unsigned APK, unsigned AAB, signed AAB)
• Comprehensive artifact collection and retention
• Intelligent caching strategy to optimize build performance

This release significantly enhances the production readiness of NativePHP Mobile applications with proper signed build support and a robust CI/CD pipeline for quality assurance.

• fix for iOS if no deep link scheme is set in env

• respects --no-tty flag on iOS builds

• Updates SecureSet signature to allow null values

• refactors android significantly
• adds testing
• slims the install function and moves more logic to the run function
• adds secure storage support for android

• adds support for failing --no-tty support

• Headless environment support - Checks for xdg-open availability before attempting to open file manager

• TTY-free execution - Compatible with headless environments

• iOS installation restricted to macOS only
• Clear error messages for invalid platform specifications
• Maintains backward compatibility with existing interactive flow

• fix for non-icu installs (Android)

• Adds support for icu/intl
• This enables packages like FilamentPHP to work 🎉

• Adds hot reloading for Android 🔥
• Fix for incorrectly stopping redirects to same url (redirect()->back() supported) ↪️

• Fix: On non-Darwinian machines, default to 'android' $os

• fixes loading Android if any os is specified

• Defaults jdk and sdk paths to null
• Removes overriding app name
• Allows back button press to go to last page
• Enables audio
• ensureValidAppId on Run command
• Replaces updating local properties file with SDK information
• Adds support for exclude dirs config on Android
• Updates config
• Adds linux support
• Adds support for Inertia to iOS

• Fix typo

• Fix tty on Windows Android

• iOS v1
• Android v1

• 📱 Update static libraries package to use the latest version: 0.3.1
• 📱 Improve native:run execution timeout
• 📱 Include license files in the static libraries package
• 📱 PHP upgraded to 8.4.5

If you're already running v0.3, you may simply run composer update to get this version.

Once installed, you MUST also run php artisan native:install --force to ensure that your Xcode project is fully up to date.

Full Changelog: https://github.com/NativePHP/ios/compare/0.3.1...0.3.2

• 📱 Adds support for standard links in the webview, opening them in the default app registered for that scheme (e.g. the browser, for http and https)

If you're already running v0.3, you may simply run composer update to get this version.

Once installed, you MUST also run php artisan native:install --force to ensure that your Xcode project is fully up to date.

Full Changelog: https://github.com/NativePHP/ios/compare/0.3.0...0.3.1

• 🎉 Introduces the first set of APIs for the initial native functionality: camera (photo), vibrate, share sheets, alerts, biometric ID and push notification registration (docs updated too)
• 📱 Basic swipe-to-navigate gesture support - you can now go back and forward in the webview with a simple LTR/RTL gesture
• 🏗️ Improve application build pipeline to be more reliable and slightly faster
• 💪🏼 Reduces final app size thanks to smaller libraries for PHP and its dependencies
• 👷🏼 WIP: Various fixes needed for Inertia support. More to come

You will need to run composer require nativephp/ios in order to get this latest version as it's considered a major release during the EAP.

Once installed, you MUST also run php artisan native:install --force to ensure that your Xcode project is fully up to date.

Full Changelog: https://github.com/NativePHP/ios/compare/0.2.4...0.3.0

Full Changelog: https://github.com/NativePHP/ios/compare/0.2.3...0.2.4

Full Changelog: https://github.com/NativePHP/ios/compare/0.2.2...0.2.3

Full Changelog: https://github.com/NativePHP/ios/compare/0.2.1...0.2.2

Full Changelog: https://github.com/NativePHP/ios/compare/0.2.0...0.2.1

Full Changelog: https://github.com/NativePHP/ios/compare/0.1.0...0.2.0

No description available for this release.