Building wheel for opencv-python (PEP 517)エラーの解決方法

★悩み★
・pip install opencv-pythonが異常終了する。
・「Building wheel for opencv-python (PEP 517)」のエラー発生原因は？
・「Building wheel for opencv-python (PEP 517)」の解決方法は？

こういった「悩み」に答えます。
　

★本記事の内容★
① Building wheel for opencv-python (PEP 517)の発生経緯
➁ Building wheel for opencv-python (PEP 517)の発生原因
➂ Building wheel for opencv-python (PEP 517)の解決方法

これからご紹介する「Building wheel for opencv-python(PEP 517)エラーの解決方法」を実践したことで、筆者は5分以内で「Building wheel for opencv-python(PEP 517)エラーを解決」できました。
　

記事の前半では「Building wheel for opencv-python(PEP 517)が発生した経緯と原因」を解説します。

記事の後半では「Building wheel for opencv-python(PEP 517)エラーを解決する手順」を紹介します。
　

この記事を読み終えることで、「Building wheel for opencv-python(PEP 517)を解決し、正常にpip install opencv-pythonを実行できる」状態になります。

　

Building wheel for opencv-python (PEP 517)の発生経緯
Building wheel for opencv-python (PEP 517)の発生原因
Building wheel for opencv-python (PEP 517)の解決方法
【まとめ】Building wheel for opencv-python(PEP 517)エラーの解決方法

Building wheel for opencv-python (PEP 517)の発生経緯

「Building wheel for opencv-python (PEP 517)の発生経緯」に関して解説します。
　

本事象が発生した当時は、納期が近く、そうとう慌てふためいた記憶があります。

筆者は、Pythonの「opencv-python」ライブラリをインストールするために、以下のコマンドをWindows上で実行しました。

C:\Users\user>pip install opencv-python

上記コマンド実行後、以下のエラーが発生し、「opencv-python」ライブラリのインストールが失敗しました。

Building wheels for collected packages: opencv-python
  Building wheel for opencv-python (PEP 517) ...
・
・
・
Installation Failed

本事象は、以下の日時と環境で発生しました。
動作確認済み日時：2022年6月21日
動作確認済み環境：Windows 10

以上が、「Building wheel for opencv-python (PEP 517)の発生経緯」となります。

　

Building wheel for opencv-python (PEP 517)の発生原因

「Building wheel for opencv-python (PEP 517)の発生原因」に関して解説します。
　

Building wheel for opencv-python (PEP 517)が発生する原因として、「pipのバージョンが古い」があります。

本事象「Building wheel for opencv-python (PEP 517)」が発生する原因は、以下となります。
　

★Building wheel for opencv-python (PEP 517)が発生する原因★
pipのバージョンが古いことが原因です。
筆者の環境では「pipのバージョンが19.0.2」でした。
そのため、「opencv-pythonライブラリのために、wheelライブラリをビルドしたが、pipが古く正常にビルドができない」というエラー内容になります。

ちなみに、以下のコマンドを実行することで、「インストールされたpipのバージョンを確認」できます。

C:\Users\user>pip -V
pip 19.0.2 from

以上が、「Building wheel for opencv-python (PEP 517)の発生原因」となります。

　

Building wheel for opencv-python (PEP 517)の解決方法

「Building wheel for opencv-python (PEP 517)の解決方法」に関して解説します。
　

Building wheel for opencv-python (PEP 517)を解消するために、pipを最新版にバージョンアップさせましょう。

pipを最新版にバージョンアップさせるために、以下のコマンドを順番に実行してください。

C:\Users\user>pip install --upgrade pip
C:\Users\user>pip -V
pip 22.0.4 from C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.10_3.10.1520.0_x64__qbz5n2kfra8p0\lib\site-packages\pip (python 3.10)

C:\Users\user>

コマンド実行後、pipのバージョンが更新されていた場合、「正常にpipを最新版にバージョンアップできた」と判断できます。
　

以上が、「Building wheel for opencv-python (PEP 517)の解決方法」となります。
　

pipのライブラリが古いことで、Pythonライブラリのインストールに失敗することがあります。
定期的にpipを最新版に更新しておきましょう。

【まとめ】Building wheel for opencv-python(PEP 517)エラーの解決方法

いかがでしたでしょうか？

「Building wheel for opencv-python(PEP 517)が発生する原因」、「Building wheel for opencv-python(PEP 517)が発生した場合の調査と対処方法」を解説し、以下の悩みを解決しました。
　

「pipを更新」するだけで、「Building wheel for opencv-python(PEP 517)」エラーを解決できることがあります。

ぜひあなたも本記事を参考に「pip install opencv-python」実行時に発生する「Building wheel for opencv-python (PEP 517)エラー」を解決してみてください。