Skip to content

Commit 5a989d7

Browse files
committed
feat: add common issue 3
1 parent 2d24108 commit 5a989d7

File tree

1 file changed

+38
-0
lines changed

1 file changed

+38
-0
lines changed

troubleshooting.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,44 @@ end
6060

6161
Just match the target version you use in `build.xcconfig`.
6262

63+
### Common Issue 3
64+
65+
If you ever see a build issue like the following:
66+
67+
```
68+
dyld: Symbol not found: __ZNSt3__115basic_stringbufIcNS_11char_traitsIcEENS_9allocatorIcEEE3strERKNS_12basic_stringIcS2_S4_EE
69+
Referenced from: /path/to/app/platforms/ios/internal/metadata-generator-x86_64/bin/./objc-metadata-generator (which was built for Mac OS X 12.0)
70+
Expected in: /usr/lib/libc++.1.dylib
71+
```
72+
73+
This can happen when a lib uses a symbol accessible from a lower minimum target.
74+
75+
**Solution**: Use `build.xcconfig` and your own `Podfile` to target a minimum version, for example:
76+
77+
- In `build.xcconfig`, add this:
78+
79+
```
80+
IPHONEOS_DEPLOYMENT_TARGET = 12.0;
81+
```
82+
83+
You can adjust lower or higher depending on needs.
84+
85+
- If you don't have one already, you can add `App_Resources/iOS/Podfile` with the following:
86+
87+
```
88+
platform :ios, '12.0'
89+
90+
post_install do |installer|
91+
installer.pods_project.targets.each do |target|
92+
target.build_configurations.each do |config|
93+
config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '12.0'
94+
end
95+
end
96+
end
97+
```
98+
99+
Just match the target version you use in `build.xcconfig`. Be sure to `ns clean` each time you make adjustment before running again.
100+
63101
## iOS run on device
64102

65103
If you see a message like the following when trying to run on a connected iOS device:

0 commit comments

Comments
 (0)