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 selectProduct
in the menu bar at the top. Then selectbuild
. Once XCode indicates a build failure, click the red circle with anx
in it to be shown the error.
npm run prebuild:ios
Error running 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
- If you have both a
gem
-installed cocoapods AND abrew
-installed, this is bad, you must delete one of those. - If your
cocoapods
has been installed viagem
, upgrade it:gem install cocoapods -v 1.14.3
- If your
cocoapods
has been installed viewbrew
, 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.
yarn iOS
Error running 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