Troubleshooting - openwallet-foundation-labs/learner-credential-wallet GitHub Wiki

Errors Encountered

Try Clearing Your Cache

  • npm cache clean --force
  • pod cache clean --all
  • yarn cache clean

Troubles with installation?

  • rm -rf node_modules
  • rm -rf package-lock.json

After the cache is cleared, re-setup the LCW app on your command line and try again.

iOS Related

  • If you experience failures running the iOS simulator go into XCode and select Product in the menu bar at the top. Then select build. Once XCode indicates a build failure, click the red circle with an x in it to be shown the error.

Error running npm run prebuild:ios

On latest main (post-React Native/Expo upgrade), when running npm run prebuild:ios, generates error:

✔ Finished prebuild
⚠️  Something went wrong running `pod install` in the `ios` directory.
Command `pod install` failed.
└─ Cause: Invalid `Podfile` file:
[!] Invalid `RNKeychain.podspec` file: undefined method `visionos' for #<Pod::Specification name="RNKeychain">.

This is due to an older install of the cocoapods library. To fix:

Determine which cocoapods lib you have installed, and by what method. Run: gem which cocoapods and brew ls cocoapods

  1. If you have both a gem-installed cocoapods AND a brew-installed, this is bad, you must delete one of those.
  2. If your cocoapods has been installed via gem, upgrade it: gem install cocoapods -v 1.14.3
  3. If your cocoapods has been installed view brew, upgrade it: brew switch [email protected]

Xcode 16.3 may need downgrading to 16.2

If you are using Xcode 16.3, you may get obscure errors that are apparently caused by an incompatibility between Xcode 16.3 and versions of react-native older than 0.76. As of May 26 2025 we are at v0.73.4 so we are susceptible to the problem. The react people have a fix for version 0.76.9 of react-native, but won't fix any older versions because they are outside the support window. For older versions, the recommended workaround (from the react people) is to downgrade Xcode to 16.2 (or to upgrade react-native which we'll have to soon do).

Read more about it here:

https://www.reddit.com/r/reactnative/comments/1jp2c5c/upgrade_to_xcode_163_after_fix_has_been_released/ https://github.com/facebook/react-native/issues/50411#issuecomment-2776681575 https://github.com/facebook/react-native/releases/tag/v0.76.9

One such error is when running iOS prebuilt:ios :

✔ Cleared ios code ✔ Created native directory › Using current versions instead of recommended [email protected]. ✔ Updated package.json | no changes » ios: ios.backgroundColor: Install expo-system-ui to enable this feature https://docs.expo.dev/build-reference/migrating/#expo-config--backgroundcolor--depends-on ✔ Finished prebuild ⚠️ Something went wrong running pod install in the ios directory. Command pod install failed. └─ Cause: Failed to load 'glog' podspec: [!] Invalid glog.podspec file: undefined method '[]' for nil.

So if you are on 16.3 with odd errors, you can try downgrading to 16.2. Do that by downloading 16.2 from the Apple Downloads page:

https://developer.apple.com/download/all/

You’ll have to sign in with your Apple ID.

The download is an archive. After downloading double click the archive to extract the Xcode app and then run the app by double clicking it.

You’ll also have to make sure to set the Command Line tools to 16.2 as well:

And then try again. To switch back to Xcode 16.3 close 16.2 and resume using the 16.3 file (making sure to again switch the command line tools to the matching version).

Note again that this problem with 16.3 seems to be only with versions of react 0.76 and below. Once we’ve updated LCW to a newer version this problem should hopefully go away.

Current Known Bug as of Dec 2023 for iOS

An error about the RTC_Folly Pod. To fix this, you'll need to fix the syntax of a function call (as of writing) on line 131 from std::unary_function to std::__unary_function in a file named hash. You'll be able to access this and fix it via the XCode GUI and the steps directly above.

Error running yarn iOS

You may get the following error:

Your computer requires some additional setup before you can build onto physical iOS devices. Learn more: https://expo.fyi/setup-xcode-signing CommandError: No code signing certificates are available to use. error Command failed with exit code 1. info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

You may need to add your developer account and/or setup signing certificates. As suggested in the error, follow the instructions at:

https://yarnpkg.com/en/docs/cli/run

There might be slight differences from those instructions if you've already got an account and simply need to renew your certificate.

Android Related

Android hangs on App, does not load

If prebuild is successful, but app hangs on splash page, try disabling Flipper (commenting out) locally on the following files located inside your Android directory AFTER prebuild step:

  • android/app/src/main/java/app/lcw/MainApplication.kt
  • android/app/build.gradle

Would need to comment out this line on build.gradle, for example: implementation("com.facebook.react:flipper-integration")

(on MAC) Error: EMFILE: too many open files, watch at FSEvent.FSWatcher._handle.onchange (node:internal/fs/watchers:207:21)

Will need to install watchman brew install watchman. If this doesn't work, run watchman: watchman.

Execution failed for task ':react-native-async-storage_async-storage:compileDebugJavaWithJavac'.

LCW works optimally with JDK 17, please refer to this issue: https://github.com/react-native-async-storage/async-storage/issues/1057

Archived / No Longer Applicable Errors

This project was started with Expo, but had to be ejected because some libraries did not support it. Do not develop using Expo, even if it might still launch. That being said, we are still using unimodules, so feel free to install and use packages from the Expo community.

If you get cryptic errors like the following:

** BUILD FAILED **

The following build commands failed:
	CompileC /Users/jc/Library/Developer/Xcode/DerivedData/eduwallet-cikpfctcsrnvkqflqlievgbjvnfr/Build/Intermediates.noindex/Pods.build/Debug-iphonesimulator/RealmJS.build/Objects-normal/x86_64/RealmReact.o /Users/jc/gitlab\ github/digitalcredentials/learner-credential-wallet/node_modules/realm/react-native/ios/RealmReact/RealmReact.mm normal x86_64 objective-c++ com.apple.compilers.llvm.clang.1_0.compiler (in target 'RealmJS' from project 'Pods')
(1 failure)

Then check your version of cocoa pods. If it is 1.9.3, try upgrading it to something newer, like 1.11.2_1