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

Improve the MacOS documentation #54

Merged
merged 7 commits into from May 5, 2022

Conversation

Drabble
Copy link
Collaborator

@Drabble Drabble commented Apr 28, 2022

I was confused when I looked at the building documentation in the mdbooks because the first section specified Linux but the command cargo run can be used on many platforms with the right Rustup toolchain target. I also think that the cargo build command should be mentioned first instead of cargo run as we are in the building documentation.

I have extended the MacOS documentation with my experience trying to run it in XCode.

Finally I have moved the note about building in XCode that was written in the root README.md to the mdbooks. I think it helps keep the README cleaner. Also in my tests I was not required to pre-build the Rust application (as said in the note) but I will try again on a clean environment tomorrow.

This is my first contribution to the project, I am sorry in advance if I made something wrong and I would be very pleased if you can give me feedback so I don't make the same mistakes again.

@Drabble
Copy link
Collaborator Author

Drabble commented Apr 29, 2022

I have tested on a MacOS with version 12.1, no XCode and no Rust installed.

I followed these steps :

  1. Install XCode
  2. Install Rustup
  3. Clone https://github.com/Drabble/maplibre-rs.git and checkout on branch cargo-configuration (I think the checkout was not required)
  4. Open the xcode folder with XCode
  5. Change the macOS deployment target to 12.1
  6. Run

It worked first try without the need to pre-build manually the maplibre_apple library.

@maxammann
Copy link
Collaborator

I have tested on a MacOS with version 12.1, no XCode and no Rust installed.

I followed these steps :

  1. Install XCode
  2. Install Rustup
  3. Clone https://github.com/Drabble/maplibre-rs.git and checkout on branch cargo-configuration (I think the checkout was not required)
  4. Open the xcode folder with XCode
  5. Change the macOS deployment target to 12.1
  6. Run

It worked first try without the need to pre-build manually the maplibre_apple library.

Yes, i fixed that last week. No more need to compile it first :)

.idea/misc.xml Outdated Show resolved Hide resolved
apple/xcode/maplibre-rs.xcodeproj/project.pbxproj Outdated Show resolved Hide resolved
docs/src/development-guide/building.md Outdated Show resolved Hide resolved
docs/src/development-guide/building.md Outdated Show resolved Hide resolved
docs/src/development-guide/building.md Outdated Show resolved Hide resolved
docs/src/development-guide/building.md Outdated Show resolved Hide resolved
docs/src/development-guide/building.md Outdated Show resolved Hide resolved
docs/src/development-guide/building.md Outdated Show resolved Hide resolved
Copy link
Collaborator Author

@Drabble Drabble left a comment

Choose a reason for hiding this comment

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

Reverting MacOS deployment target

apple/xcode/maplibre-rs.xcodeproj/project.pbxproj Outdated Show resolved Hide resolved
apple/xcode/maplibre-rs.xcodeproj/project.pbxproj Outdated Show resolved Hide resolved
This file was mistakenly commited.
Copy link
Collaborator Author

@Drabble Drabble left a comment

Choose a reason for hiding this comment

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

Apply all the suggestions to fix the MacOS documentation.

@Drabble Drabble merged commit 36a4bcd into maplibre:main May 5, 2022
@Drabble Drabble deleted the macos-documentation branch May 5, 2022 12:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants