Homebrewでheaderやxcodeのアップデートなどでエラーが出た場合の対処法

この記事のタイトルとURLをコピーする

わかること

「Homebrew」をターミナルでアップデートする。
「XCODE」をターミナルでアップデートする。
不要なファイルを削除する。

つね

1年前にプログラミングの勉強をしようと思ってベトナムIT留学に参加して、それっきり開発環境の1つのHomebrewをアップデートしないままだったんだよね〜。

それだとどうなるの？

将来は海外に住みたい犬

つね

開発環境のアップデートをしていないので、エラーがたくさん起きる・・・！

開発環境のエラーって、直すの簡単なの？

将来は海外に住みたい犬

僕の開発環境で起きたエラーは

Homebrew自体のアップデート
XCODEのアップデート
いらないファイルをどうにかしてね(←これがちょっと厄介だった)

の3つだったよ。

なんか3つ目のエラーの解決がちょっと面倒そう。。。。

将来は海外に住みたい犬

つね

そうなんだよね〜。

どんな風に解決したのか、教えてくれない？

将来は海外に住みたい犬

つね

同じエラーに行き詰まる人ももしかしたらいるかもしれないので、備忘録的に残しておくね。

開発環境とエラーの原因

つね

最初に僕が使っている開発環境をお伝えするね。

開発環境

macOS Catalina バージョン 10.15.6

つね

これが僕が使っている開発環境です。

この環境でエラーが起きたんだね。

将来は海外に住みたい犬

起きたエラーは3つ

つね

さっきも紹介したけど、起きたエラーの種類を紹介するね。

なんか友達みたいに言うね笑。

将来は海外に住みたい犬

起きたエラー

Homebrew自体のアップデート。
XCODEのアップデート。
いらないファイルをどうにかしてね。

これらのエラーの解決方法を順番に紹介していきます。

Homebrewのアップデート方法

そもそもHomebrewってなんなの？

Homebrew

Homebrewとは：

Homebrewって便利なツールなんだね。

将来は海外に住みたい犬

つね

とにかく入れておくことが必須なツールですね。

Homebrewのアップデートはどうやってするの？

将来は海外に住みたい犬

つね

Homebrewのアップデート方法は簡単で、ターミナルで以下のコマンドを入力してEnterを押すと完了します。

brew update

たったこれだけのコマンドで簡単にHomebrewのアップデートができるんだね。

将来は海外に住みたい犬

つね

ちなみにあなたの開発環境でHomebrewが大丈夫かどうか、チェックするならこちらのコマンドです。

brew doctor

つね

このコマンドを入力すると、エラーがあるのかどうか、判別して教えてくれます。

なお、エラーがなにも無いときは

Your system is ready to brew.

と返ってくるので、この文章が返ってきたときは大丈夫です。

XCODEのアップデート方法

つね

brew doctorでXCODEのアップデートを要求されたので、その解決方法もお伝えしますね。

XCODEってなんなの？

将来は海外に住みたい犬

XCODEとは：

つね

XCODEのアップデート方法も簡単で、ターミナルで以下のコマンドを入力するだけで完了します。

xcode-select --install

このコマンドを入力した後に、別ウィンドウが開いて「インストール」というボタンが表示されます。

「インストール」というボタンをクリックして、数分待つとXCODEの最新版がパソコンに入っています。

これでXCODEのアップデートは完了です。

「いらないファイルをどうにかしてね」の解決法

つね

最後に残ったエラーが「いらなそうなファイルをどうにかしてね」のエラーです。

どんなエラーメッセージだったの？？

将来は海外に住みたい犬

つね

具体的なエラーメッセージはこちら。

Homebrewでのエラー画面

Please note that these warnings are just used to help the Homebrew maintainers
with debugging if you file an issue. If everything you use Homebrew for is
working fine: please don't worry or file an issue; just ignore this. Thanks!

Warning: Unbrewed header files were found in /usr/local/include.
If you didn't put them there on purpose they could cause problems when
building Homebrew formulae, and may need to be deleted.

つね

めちゃくちゃ簡略化していうと、「Homebrewで問題があるかもやけど、もし普通に使えてるなら気にせんといてな。ありがとう！警告しておくと、headerに目的なく置いてるファイル、あれ今後問題になるかもやから削除とかしといた方がいいと思うで！ほな！」みたいな感じです。

なんか、、一応消しておこうってなる感じの内容だね。笑

将来は海外に住みたい犬

ということで色んなサイトをググりながら、ファイルを削除する方法を調べてやってみました。

方法その1：ファイルにまとめて一括削除

エラーメッセージの下にたくさん出てきているファイル。

あれらが削除対象のファイルです。

これらのファイルを一括で削除するために、vim ~/.del_files.shでファイルを作成して、その中にいらないファイルたちを入れて一括削除。

https://qiita.com/6592sho/items/b24766e203fb7a48b056

こちらのサイトを参考にやってみたのですが、permission deniedが出て削除出来ず。。。

方法その2：sudoコマンドで強制的に削除

方法1だとpermission deniedが出たので、ファイル内容も消して問題がなさそうだったので、強制的にsudoコマンドを使ってファイルの削除を行いました。

sudo rm -R /usr/local/include/node

本当だったらあまり使いたくないコマンドだったのですが。。。。

ファイルを削除してbrew doctorをすると

Your system is ready to brew.

が出たので、Homebrewの設定は完了しました。

Homebrewでheaderやxcodeのアップデートなどでエラーが出た場合の対処法のまとめ

まとめ

「Homebrew」本体のアップデートはbrew updateをターミナルで実行。
「Homebrew」で問題があるかどうか調べるコマンドはbrew doctor。
「XCODE」のアップデートはxcode-select --installをターミナルで実行。
いらないファイルの削除は色々試してみて、最終手段はsudoコマンドで削除。
Homebrewの準備が完了すると、「Your system is ready to brew.」というメッセージが表示される。