Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

added installation troubleshooting info for macOS users #1924

Open
wants to merge 10 commits into
base: master
Choose a base branch
from
21 changes: 17 additions & 4 deletions INSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -266,13 +266,19 @@ If this works, then proceed to [Installation](#installation). Otherwise, ask for

> This guide installs libpng via Homebrew as it is the easiest method, however advanced users can install libpng through other means if they so desire.
</details>
<details>
<summary><i><strong>Note for Apple Silicon (M1) Mac users...</strong></i></summary>

> Currently, Homebrew and libng must be installed via Rosetta on Apple Silicon Macs. Before continuing, create a [Terminal shell profile with Rosetta](https://www.astroworldcreations.com/blog/apple-silicon-and-legacy-command-line-software). Be sure to run the commands corresponding to Apple Silicon (M1).
</details>

1. Open the Terminal.
2. If Homebrew is not installed, then install [Homebrew](https://brew.sh/) by following the instructions on the website.
3. Run the following command to install libpng.

```bash
brew install libpng
brew install libpng # Intel Macs
/usr/local/bin/brew install libpng # Apple Silicon (M1) Macs
Comment on lines +269 to +281
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Imo these changes are not necessary

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I still can't speak to M1, but now on an M3 I can add that in addition to brew install libpng I needed to install pkg-config with brew install pkg-config in order for libpng to be found.

```
libpng is now installed.

Expand All @@ -290,16 +296,23 @@ If this works, then proceed to [Installation](#installation). Otherwise, ask for
```

The command with gba-dev will ask for the selection of packages to install. Just press Enter to install all of them, followed by entering Y to proceed with the installation.
<details>
<summary><i>Note for users with trouble running 'sudo dkp-pacman -Sy'...</i></summary>

> Using a VPN may help accesing devkitpro servers.
</details>
4. After the tools are installed, devkitARM must now be made accessible from anywhere by the system. To do so, run the following commands:

```bash
export DEVKITPRO=/opt/devkitpro
echo "export DEVKITPRO=$DEVKITPRO" >> ~/.bashrc
echo "export DEVKITPRO=$DEVKITPRO" >> ~/.bashrc # Intel Macs
echo "export DEVKITPRO=$DEVKITPRO" >> ~/.zshrc # Apple Silicon (M1) Macs
export DEVKITARM=$DEVKITPRO/devkitARM
echo "export DEVKITARM=$DEVKITARM" >> ~/.bashrc
echo "export DEVKITARM=$DEVKITARM" >> ~/.bashrc # Intel Macs
echo "export DEVKITARM=$DEVKITARM" >> ~/.zshrc # Apple Silicon (M1) Macs

echo "if [ -f ~/.bashrc ]; then . ~/.bashrc; fi" >> ~/.bash_profile
echo "if [ -f ~/.bashrc ]; then . ~/.bashrc; fi" >> ~/.bash_profile # Intel Macs
echo "if [ -f ~/.zshrc ]; then . ~/.zshrc; fi" >> ~/.zprofile # Apple Silicon (M1) Macs
Comment on lines -298 to +315
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But these changes are good and helpful, since M1 macs are going to be using zsh by default now

```

### Choosing where to store pokeemerald (macOS)
Expand Down