Home › Build error fixes › iOS / Xcode
Terminal encoding is not UTF-8
iOS / Xcode · last reviewed 2026-11-10
The error looks like this
WARNING: CocoaPods requires your terminal to be using UTF-8 encoding.
Why it happens
LANG is unset, common in CI and some shells.
How to fix it
- export LANG=en_US.UTF-8 && export LC_ALL=en_US.UTF-8 (add to ~/.zshrc or the CI env).
Not sure this is your error? Let ReleaseMedic read the whole log
Build logs are long and the last line is rarely the real cause. ReleaseMedic finds the first real error, explains it and gives the steps — free, and the log never leaves your computer.
$ npx releasemedic log build.logOr pipe a build straight in: cd android && ./gradlew bundleRelease 2>&1 | npx releasemedic log -
Catch it before you build
Most release errors come from project settings you can check in seconds — signing, SDK levels, privacy manifests, permissions, push and login setup.
$ npx releasemedic