iOS - CocoaPods requires your terminal to be using UTF-8 encoding - after latest flutter upgrade

Question

I am getting this error after I upgraded flutter. Before upgrading everything was working normal on both iOS and android. Now my project is not building in iOS.

Below is my terminal info.

pod setup --verbose

    WARNING: CocoaPods requires your terminal to be using UTF-8 encoding.
Consider adding the following to ~/.profile:

export LANG=en_US.UTF-8

pod install --verbose

WARNING: CocoaPods requires your terminal to be using UTF-8 encoding.
Consider adding the following to ~/.profile:

export LANG=en_US.UTF-8

[!] No `Podfile' found in the project directory.


/Library/Ruby/Gems/2.3.0/gems/cocoapods-1.8.4/lib/cocoapods/command.rb:151:in `verify_podfile_exists!'
/Library/Ruby/Gems/2.3.0/gems/cocoapods-1.8.4/lib/cocoapods/command/install.rb:46:in `run'
/Library/Ruby/Gems/2.3.0/gems/claide-1.0.2/lib/claide/command.rb:334:in `run'
/Library/Ruby/Gems/2.3.0/gems/cocoapods-1.8.4/lib/cocoapods/command.rb:52:in `run'
/Library/Ruby/Gems/2.3.0/gems/cocoapods-1.8.4/bin/pod:55:in `<top (required)>'
/usr/local/bin/pod:22:in `load'
/usr/local/bin/pod:22:in `<main>'

locale

LANG=
LC_COLLATE="C"
LC_CTYPE="C"
LC_MESSAGES="C"
LC_MONETARY="C"
LC_NUMERIC="C"
LC_TIME="C"
LC_ALL=

https://stackoverflow.com/questions/69070537/getting-error-while-run-flutter-app-in-ios check this out, cocoapods 10.0.1 works — Jackie Jensen, Oct 02 '21 at 18:12
Setting the `export LANG` settings in the .zshrc didn't work for me, so I ended up with: `$ LANG=en_US.UTF-8 `. Source: [cocoaPods issue](https://github.com/CocoaPods/CocoaPods/issues/6333#issuecomment-268522581) — FrugalResolution, Jun 11 '22 at 18:24

score 219 · Answer 1 · edited Jun 14 '22 at 20:16

219

Open Terminal
Type open ~/.zshrc (or open ~/.profile if you don't use zsh)

It seems that LANG="en_US.UTF-8" alone isn't enough, so you have to set:

export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8

Save the file
Go back to Terminal and type source ~/.zshrc and type locale
You can now safely run pod update or pod install

edited Jun 14 '22 at 20:16

DenFav

2,683
1
18
27

answered Sep 30 '21 at 16:21

Job M

3,331
2
19
26

12

possibly need to restart Android Studio after applying the change. – Ber May 29 '22 at 11:12
Definetely @Ber – idish Sep 06 '22 at 06:36
I had to make new .zshrc file in home and after making all changes mentioned, restarted the system. It Worked... – Ajmal Hasan Dec 08 '22 at 06:23
1

@AjmalHasan you could have just sourced the new update without restarting the system (if you don't need to) by executing this in the terminal session: ` source ~/.zshrc ` – Intellect Mar 23 '23 at 00:51

score 38 · Answer 2 · answered Oct 30 '20 at 17:40

38

After one day of struggle finally i found the full solution

Follow these steps to solve this issue

Unhide filles in Mac using Cmd + Shift + dot.
Go to Macintosh HD -> User -> (Your user ).
Search for .zshrc
Open it with any editor (I recommend VS code)
Under. #User configuration comment out export LANG=en_US.UTF-8.
Open your flutter project and manually delete Pods folder, Podfile, Podfile.lock. (back-up all podfiles)
Restart your Mac and run your flutter application
Run pod install
It will automatically create podfile and its new config in UTF - 8 encoding
Enjoy and chill i got your back !!!!!

answered Oct 30 '20 at 17:40

J Jiju Thomas

489
4
3

1

Thanks, It works for me... save my time... Note: make sure you don't forgot to restart your system. – Dhaval Kansara Sep 07 '21 at 08:20
It did solve the issue, but what caused it, that my app was running fine a few minutes ago. – ASAD HAMEED Dec 16 '21 at 08:01
1

If this export LANG=en_US.UTF-8 does not work then you can use export LC_ALL=en_US.UTF-8 – eclat_soft Feb 21 '22 at 23:03
removing Podfile.lock was enough – RandomCoder Aug 30 '23 at 06:52

Delicia Fernandes · Answer 3 · 2021-11-08T07:35:23.147

18

Clean files with flutter clean
Type vim .zshrc in your terminal. This should open up your .zshrc profile. Type I to insert something. Then, simply paste in export LANG=en_US.UTF-8 and hit ESC to get out and then type :wq to save and quit.
Opened project folder, next open iOS folder in mac terminal and run pod install
It may give warning of using ios 9.0 so update it to 10.0, for that open Podfile in text edit and uncomment or change # platform :ios, '9.0' to platform :ios, '10.0'
Run flutter build iOS in the main root project through the terminal.
Run main root file eg. flutter run

If you are facing a problem with Flutter. Try this solution

Delete the Podfile, Podfile.lock, Pods folder, Runner.xcworkspace
flutter clean
flutter build ios

edited Nov 08 '21 at 07:35

answered May 27 '20 at 10:39

Delicia Fernandes

582
12
19

2

I get the following when i install pod [NOTE] You may have encountered a bug in the Ruby interpreter or extension libraries. Bug reports are welcome. For details: https://www.ruby-lang.org/bugreport.html [IMPORTANT] Don't forget to include the Crash Report log file under DiagnosticReports directory in bug reports. – Mohamed Abdul-Malik Jun 15 '21 at 11:33
Hey @MohamedAbdul-Malik, refer this link for some help: https://stackoverflow.com/q/40770482/13400029 – Delicia Fernandes Jun 15 '21 at 12:29
1

This worked for me on macOS montery – Al Mamun Nov 14 '21 at 00:54

score 10 · Accepted Answer · edited Nov 18 '21 at 11:31

10

finally i have solved this with below steps

export LANG=en_US.UTF-8
opened project in Xcode and cleaned it.
opened iOS folder in mac terminal and ran pod install
it gave me warming of using ios 9.0 so i updated it to 10.0
ran flutter build ios
project build successfully
opened Runner.xcworkspace in xode
clicked on run - this time Xcode again installed pod automatically

and Solved.

edited Nov 18 '21 at 11:31

Deven

3,078
1
32
34

answered Dec 19 '19 at 11:41

shruti tupkari

1,149
1
6
17

1

where should i add this export LANG=en_US.UTF-8 – Hassan Hallak Oct 14 '20 at 23:32
"1." is the question and you have answered the question with the question statement. – Waheed Akhtar Dec 10 '20 at 18:18
For fish shell users, add `set -gx LC_ALL en_US.UTF-8` to your ~/.config/fish/config.fish file. – Alejandro H. Cruz Jan 27 '22 at 14:04

tyirvine · Answer 5 · 2021-12-30T14:22:06.303

To iterate on Shruti Tupkari's answer ~ To add in export LANG=en_US.UTF-8 to your terminal it needs to be added to a profile such as .zshrc , .bashrc , or .bash_profile .

To do this simply use vim

So try

vim .zshrc

This should open up your .zshrc profile. Type 'i' to insert something.

Then simply paste in export LANG=en_US.UTF-8 hit esc to get out and then type :wq to save and quit

Try and run your app again. If you get the error, repeat the same steps on the other profiles in your computer.

Here's some information on how to use vim

https://www.howtoforge.com/vim-basics

score 5 · Answer 6 · answered Nov 12 '21 at 17:36

5

If adding export LANG=en_US.UTF-8 doesn't help, try export LC_ALL="en_US.UTF-8"

Credits: https://github.com/CocoaPods/CocoaPods/issues/6333#issuecomment-551052399

answered Nov 12 '21 at 17:36

master_dodo

1,203
3
20
31

score 5 · Answer 7 · answered Apr 21 '22 at 19:20

5

In my case the following needed to be added to .bash_profile instead of the other suggested files.

export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8

answered Apr 21 '22 at 19:20

JarWarren

1,343
2
13
18

1

Same here. Tried .profile, .zprofile, .zshrc. Worked with bash_profile – Zalexei Jul 27 '22 at 15:01
1

This works for me macOS monterey – aRyhan Dec 12 '22 at 09:26

Anantha Eswar · Answer 8 · 2022-10-19T05:22:18.843

Solving Cocoapods UTF-8 error: (Detailed explanation)

We need to change the locale of the terminal to UTF-8.

Step 1: Open the terminal, type locale, press enter, and check what locale it shows.

Step 2: If it's a bash terminal, change it to a zsh terminal,

Step 3: Then open finder, go to mac HD, users, folder with your username, and press command+shift+. to open hidden files

Step 4: Create or open a file named .zshrc

Step 5: Paste this there:

export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8

Step 6: Save it by command + s

Step 7: Then open the terminal again and check by typing, locale and pressing enter (Then you can either keep it open or close the terminal)

Step 8: If it shows some other locale instead of UTF-8, then paste the below 3 lines and press enter:

export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8

Step 9: Then open Android Studio, go to the terminal and paste the same above 3 lines, and press enter

Step 10: Then on your project file, go to the ios folder, right-click on it, and open in the terminal, then in the terminal, do paste the same above 3 lines and press enter

Step 11: Now you can install pods in this terminal by typing, pod install.

Now it will work, if you still get the same error, go to tools -> flutter -> flutter clean and restart android studio by clicking on File -> restart ide or a similar one.

Then on your project, right-click on the ios folder and open the terminal, type locale, and press enter, if it's not in UTF-8 now, then from step 9 again up to step 11, it will work now. You can run your app on iOS devices now.

My repo -> https://github.com/anantha-eswar/

score 3 · Answer 9 · answered Sep 29 '21 at 12:40

The proper solution, without re-installing anything, can be found:

here: https://stackoverflow.com/a/69160445/3821002
and here: https://stackoverflow.com/a/69376499/3821002

The crux is to use export LC_ALL=en_US.UTF-8.

The links above explain how to do that.

score 3 · Answer 10 · answered Dec 09 '22 at 05:43

3

vim ~/.profile 

export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8

source ~/.profile

answered Dec 09 '22 at 05:43

Virluz

469
3
6

score 2 · Answer 11 · answered Jun 14 '22 at 07:35

2

if you use Android Studio, then open terminal in it with:

nano ~/.profile

add these values:

export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8

and it's very important: now you need to close Android Studio and open it again, then you will be able to make a project

answered Jun 14 '22 at 07:35

VIPLIKE

146
5

no effect, system restart required? – Rana Hyder Jul 20 '22 at 00:42

score 1 · Answer 12 · edited Apr 28 '22 at 06:13

1

After upgrading mac os big sur version I get this error when I try to build ios unity.

If you don't have the file .profile, you can create new file .profile in /Users/"user-name"/.profile

step 1: open terminal. create new file .profile

$ cd
$ touch .profile

step 2: edit .profile.add

export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8

in .profile

edited Apr 28 '22 at 06:13

Xavier Guihot

54,987
21
291
190

answered Apr 28 '22 at 03:47

Đoàn Văn Linh

11
1

FrugalResolution · Answer 13 · 2022-06-11T21:16:54.110

1

Changing the .zshrc file didn't work for me, so I ended up with executing the cmd with specific language UTF-8 definition:

$ LANG=en_US.UTF-8 <pod command>

Source: cocoaPods issue

edited Jun 11 '22 at 21:16

answered Jun 11 '22 at 18:27

FrugalResolution

568
4
18

score 1 · Answer 14 · answered Dec 03 '22 at 07:06

In my case, this error only occurs when I use the android Studio terminal to run the flutter ios app. so instead, I used Mac Terminal to run the flutter ios app, and it's working perfectly fine.

To run the flutter app from the terminal use the below command:

flutter run

score 1 · Answer 15 · answered Feb 22 '23 at 04:59

To resolve this issue, you can follow the instructions in the warning message and add the following line to your ~/.profile file:

export LANG=en_US.UTF-8

This will set the encoding to UTF-8 for your terminal session, which should allow CocoaPods to work properly with your Flutter application.

After adding the line to your ~/.profile file, save the changes and run the following command to reload the profile:

For Bash

source ~/.profile

For Zsh

source ~/.zshrc

score 0 · Answer 16 · answered Dec 11 '21 at 03:54

0

To fix this, you might want to find either your ~/.bash_profile (for bash) or ~/.zshrc (for zsh) and add the export line that you put in your ~/.profile export LANG=en_US.UTF-8

That was all I had to do.

answered Dec 11 '21 at 03:54

bsadjetey

1
1

score 0 · Answer 17 · answered May 06 '22 at 15:17

0

I had this problem only in android studio. When I switched to the terminal outside Android Studio it worked fine.

answered May 06 '22 at 15:17

Richard Jongenburger

1
1

score 0 · Answer 18 · answered May 28 '22 at 09:55

0

Just open your terminal and enter the below command

export LC_ALL=en_US.UTF-8

answered May 28 '22 at 09:55

Anand

4,355
2
35
45

score 0 · Answer 19 · answered Dec 18 '22 at 07:21

0

I have figured out the latest solution that works fine in 2022

Open iOS folder in terminal
Run command pod install, and let the process complete.
```
 pod install
```
This works fine, if not try restarting the device

answered Dec 18 '22 at 07:21

abhishek5646

1

score 0 · Answer 20 · answered Mar 23 '23 at 00:57

0

Run this in the terminal

for mac users using zsh

echo 'export LANG=en_US.UTF-8' >> ~/.zprofile 
source ~/.zprofile

for Linux users using bash

echo 'export LANG=en_US.UTF-8' >> ~/.bash_profile 
source ~/.bash_profile

answered Mar 23 '23 at 00:57

Intellect

125
7

score 0 · Answer 21 · answered May 19 '23 at 04:46

Uninstall cocoapods Installed by brew

brew uninstall cocoapods

Installed with gem

sudo gem uninstall cocoapods

Install cocoapods version 1.10.2 (stable version)

sudo gem install cocoapods -v 1.10.2

When I install with this command, it report the following error You don't have write permissions into the /usr/bin directory To solve this error, I use the following command

sudo  gem install cocoapods -v 1.10.2 -n /usr/local/bin

score 0 · Answer 22 · answered Jul 21 '23 at 18:33

Solution Working in my MacBook Pro 2023(14").

open Terminal
Run Command vim ~/.zshrc
Insert 2 Statements(Using i Key): export LC_ALL=en_US.UTF-8 | export LANG=en_US.UTF-8
Close & save it use Esc + :wq!
Run Command source ~/.zshrc
Now you're good to go

score 0 · Answer 23 · edited Aug 02 '23 at 13:23

0

1- open the required file

    vim ~/.zshrc

2- add:

export LANG=en_US.UTF-8

export LANGUAGE=en_US.UTF-8

export LC_ALL=en_US.UTF-8

3- Restart the terminal: 

        source ~/.zshrc
4- Restart Android Studio

edited Aug 02 '23 at 13:23

toyota Supra

3,181
4
15
19

answered Jul 28 '23 at 10:13

Hobs

1
2

iOS - CocoaPods requires your terminal to be using UTF-8 encoding - after latest flutter upgrade

23 Answers23

After one day of struggle finally i found the full solution

Linked