/expo-mega-demo

Experimenting with awesome React Native + Expo features.

Primary LanguageTypeScript

Expo Mega Demo

Experimenting with new awesome React Native + Expo features.

Work in progress. More info soon.

A preview video (click the image): Watch the video

Core features:

⚠️ Caution! Some features used in this demo are in early, experimental stage and they're not ready for production. Use at your own risk.

How to run

First time:

  1. Make sure you have Expo and all the stuff installed and configured (including Xcode)
  2. Clone the repo and update submodules: git submodule update.
  3. yarn install
  4. yarn prebuild
  5. yarn run:ios

Just to start the bundler (without rebuilding client): run yarn start.

Known issues

Most of them are caused by limited time of mine, and also by some libraries, which depend on Expo, but have not yet been updated to support latest Expo features.

  • iOS JSI Audio is not working on Hermes yet. I'm working on it. Should be working now, lmk if it's not.
  • Frequency bin labels are wrong 🤷. Eventually I needed to display them in log scale and I am too lazy to think about how to recalculate everything properly.
  • Modifying the sound.setOnAudioSampleReceived callback and the Reanimated 2 stuff requires at least picking the song again to reload properly, sometimes whole app restart is needed.
  • May not work on iOS emulator. The JSI Audio should work, but as far as I remember, the music picker does not open. And, of course, Bluetooth cannot work on simulator.
  • Not yet works for Android There's basic experimental Android support, but with issues:
    • GL View sometimes crashes
    • JSI Audio might crash after a few seconds
    • ...

Applied patches

See the the plugins section of app.json to see how the patches are applied: xw

  • patch-package for webgltexture-loader-expo@1.0.0, a dependency of gl-react-expo - it has not yet been updated to use expo-modules-core in favor of @unimodules/core.

  • expo-cli built-in plugins sets the Push Notifications capability even when expo-notifications are not installed and I see no way to disable it. Another plugin was written to delete that entitlement.

  • MusicPicker module: iOS requires another Info.plist value about Media Library usage permission - a config plugin takes care of that

No-longer-needed patches and workarounds 🎉

I started this project when Expo SDK 42 came out. So much changed since then and with each release less and less patches and workarounds were needed:

  • Linking custom native modules:

    • The custom_native_modules directory needs to be added to autolinking paths in Podfile. A config plugin takes care of that.

      It appears that it can be configured in package.json as expo.autolinking.searchPaths. It's not needed anyway, look at the next point:

    • new expo-modules-autolinking requires modules to be specified in package.json dependencies. I don't want to copy my custom native modules to node_modules they are deleted after being copied there by yarn.
    • Patched expo-modules-autolinking@0.5.1 to apply changes from this PR until it's published. Now custom native modules dir can be specified in package.json. Finally, this PR is published in upstream expo-modules-autolinking.
  • Replaced expo-av with my custom expo-av-jsi native module to support JSI Audio

    The JSI Audio streaming is now included in upstream expo-av@10.2.0 but yet for iOS only. It'a super-secret hidden feature of SDK 44.

    In SDK 45 both platforms are now supported by Expo AV. 🎉

  • patch-package for expo-gl and related libraries - needed, because of migration from @unimodules/core to expo-modules-core

  • by default, expo modules are built with xcframework if available, but that does not work for patched expo-gl, so its xcframework is deleted force build from source.

  • expo-gl installs wrong expo-modules-core dependency in its own node_modules - it is deleted, the global node_modules one is correct.

  • The AppDelegate.m is being broken by expo-dev-client config plugin, wrote another config plugin to copy the patched file.

  • patch-package for react-native-ble-plx and Podfile config plugin, because of this issue.

  • There was a postinstall.js script to perform some of the patches above (like file copy/delete). Fortunately it is no longer needed. Yay! 🎉