Skip to content

Commit

Permalink
docs: update troubleshooting (#10)
Browse files Browse the repository at this point in the history
  • Loading branch information
ronnnnn authored Sep 24, 2024
1 parent e7d65ef commit 63cb1ac
Showing 1 changed file with 12 additions and 2 deletions.
14 changes: 12 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,7 @@ install & manage versions.
# Troubleshooting

## Incompatibility Errors After Updating Ruby

If you encounter errors like the following after updating your Ruby version and running `pod`, it's likely due to a dependency mismatch:

```
Expand All @@ -69,20 +70,29 @@ CocoaPods uses Bundler to manage its dependencies. When you change Ruby versions

### Resolution

1. Navigate to your CocoaPods installation directory:
1. Set global Ruby version to your project's Ruby version:

```bash
asdf global ruby {version} # Replace {version} with your project's Ruby version
```

2. Navigate to your CocoaPods installation directory:

```bash
cd ~/.asdf/installs/cocoapods/{version} # Replace {version} with your installed version
```

2. Redownload and reinstall the dependencies:
3. Redownload and reinstall the dependencies:

```bash
bundle install --redownload
```

Now you should be able to run `pod` commands without errors.

If you still encounter issues, try reinstalling Ruby, Bundler, and CocoaPods.
See also: https://github.com/ronnnnn/asdf-cocoapods/issues/7#issuecomment-1962783967

# Contributing

Contributions of any kind welcome! See the [contributing guide](contributing.md).
Expand Down

0 comments on commit 63cb1ac

Please sign in to comment.