Skip to content

Commit 3202d75

Browse files
authored
Update documentation for errors in Mac M1 (#3749)
Signed-off-by: swastik <swastkk@gmail.com>
1 parent b2968dc commit 3202d75

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

docs/source/getting-started/install.rst

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -160,6 +160,32 @@ in the extracted directory and run::
160160

161161
This will configure ScanCode and display the command line :ref:`cli_help_text`.
162162

163+
.. note::
164+
If you encounter a "No matching distribution" error while running the ``./configure`` command on a Mac M1, it may indicate compatibility issues with the current architecture. Here's a step-by-step guide to address this:
165+
166+
- **Change Mac M1 Architecture to x86_64:**
167+
Switch the architecture from amd64 to x86_64 using the command:
168+
::
169+
170+
env /usr/bin/arch -x86_64 /bin/zsh --login
171+
- **Use Rosetta Translation:**
172+
Enable Rosetta translation in Terminal by executing:
173+
::
174+
175+
softwareupdate --install-rosetta
176+
- **Transition Homebrew from arm64 to Intel:**
177+
Change Homebrew from the arm64 architecture to the Intel (x86) architecture by running:
178+
::
179+
180+
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
181+
- **Install Intel-Specific Python:**
182+
Use Homebrew to install Python specifically optimized for Intel architecture with:
183+
::
184+
185+
/usr/local/Homebrew/bin/brew install python3
186+
187+
Then rerun the ``./configure`` command. This sets up the project according to the new architecture and ensures proper configuration.
188+
Following these steps should help resolve compatibility issues and allow smooth operation of the project on Mac M1 devices.
163189

164190
.. _windows_app_install:
165191

0 commit comments

Comments
 (0)