Update INSTALL.md for macOS #8450

Merged
eisams merged 2 commits from patch-1 into master 2024-06-29 18:25:14 +00:00
eisams commented 2024-06-12 16:20:54 +00:00 (Migrated from github.com)

Update instructions for macOS. Git-lfs is required, which is not part of a standard git install

Also point to map generator readme files

Update instructions for macOS. Git-lfs is required, which is not part of a standard git install Also point to map generator readme files
biodranik (Migrated from github.com) reviewed 2024-06-12 19:55:06 +00:00
biodranik (Migrated from github.com) commented 2024-06-12 19:55:06 +00:00

git-lfs is not required neither on Mac, nor on Linux or Windows. We do not use icu's lfs submodule.

What kind of issue did you get? After which steps? Is it really a blocker?

git-lfs is not required neither on Mac, nor on Linux or Windows. We do not use icu's lfs submodule. What kind of issue did you get? After which steps? Is it really a blocker?
eisams (Migrated from github.com) reviewed 2024-06-12 19:59:30 +00:00
eisams (Migrated from github.com) commented 2024-06-12 19:59:29 +00:00

I first did only a git clone of the main repo, but when doing the command to install the submodules I got the error that git-lfs was needed. I don't currently remember which one

After installing it, the git repo had become in an unstable state (couldn't continue the install of the submodules), so I had to redo it and did it with the right command that included the submodules from the start

I first did only a git clone of the main repo, but when doing the command to install the submodules I got the error that git-lfs was needed. I don't currently remember which one After installing it, the git repo had become in an unstable state (couldn't continue the install of the submodules), so I had to redo it and did it with the right command that included the submodules from the start
biodranik (Migrated from github.com) reviewed 2024-06-12 20:24:21 +00:00
biodranik (Migrated from github.com) commented 2024-06-12 20:24:20 +00:00

So... does following official instructions require lfs or not?

So... does following official instructions require lfs or not?
eisams (Migrated from github.com) reviewed 2024-06-13 19:19:12 +00:00
eisams (Migrated from github.com) commented 2024-06-13 19:19:12 +00:00

Yes

I uninstalled git-lfs and tried again

% git clone --recurse-submodules https://github.com/organicmaps/organicmaps.git

...

remote: Enumerating objects: 1489, done.        
remote: Counting objects: 100% (481/481), done.        
remote: Compressing objects: 100% (132/132), done.        
remote: Total 1489 (delta 407), reused 362 (delta 349), pack-reused 1008        
Receiving objects: 100% (1489/1489), 7.08 MiB | 11.55 MiB/s, done.
Resolving deltas: 100% (982/982), done.
Submodule path '3party/fast_double_parser/benchmarks/dependencies/abseil-cpp': checked out 'd936052d32a5b7ca08b0199a6724724aea432309'
Submodule path '3party/fast_double_parser/benchmarks/dependencies/double-conversion': checked out 'f4cb2384efa55dee0e6652f8674b05763441ab09'
Submodule path '3party/fast_obj': checked out '1a8060257a96401a9555a476bd13c3a87502c9b5'
Submodule path '3party/freetype/freetype': checked out '920c5502cc3ddda88f6c7d85ee834ac611bb11cc'
Submodule 'dlg' (https://github.com/nyorain/dlg.git) registered for path '3party/freetype/freetype/subprojects/dlg'
Cloning into '/Users/eivind/organicmaps/3party/freetype/freetype/subprojects/dlg'...
remote: Enumerating objects: 1180, done.        
remote: Counting objects: 100% (170/170), done.        
remote: Compressing objects: 100% (106/106), done.        
remote: Total 1180 (delta 84), reused 102 (delta 41), pack-reused 1010        
Receiving objects: 100% (1180/1180), 3.49 MiB | 9.20 MiB/s, done.
Resolving deltas: 100% (655/655), done.
Submodule path '3party/freetype/freetype/subprojects/dlg': checked out '72dfcc858c040c54a6a0b88fcb7e70ee186d3167'
Submodule path '3party/gflags': checked out 'a738fdf9338412f83ab3f26f31ac11ed3f3ec4bd'
Submodule path '3party/glm': checked out 'c834d06c2739f63e28e5665d4569dca9415e3891'
Submodule path '3party/googletest': checked out '58d77fa8070e8cec2dc1ed015d66b454c8d78850'
Submodule path '3party/harfbuzz/harfbuzz': checked out 'bc90b29b37fe3809f9e48aa7be08fbf2208e481a'
git-lfs filter-process: git-lfs: command not found
fatal: the remote end hung up unexpectedly
fatal: Unable to checkout '680f521746a3bd6a86f25f25ee50a62d88b489cf' in submodule path '3party/icu/icu'```
Yes I uninstalled git-lfs and tried again ``` % git clone --recurse-submodules https://github.com/organicmaps/organicmaps.git ```` ... ```Cloning into '/Users/eivind/organicmaps/3party/fast_double_parser/benchmarks/dependencies/double-conversion'... remote: Enumerating objects: 1489, done. remote: Counting objects: 100% (481/481), done. remote: Compressing objects: 100% (132/132), done. remote: Total 1489 (delta 407), reused 362 (delta 349), pack-reused 1008 Receiving objects: 100% (1489/1489), 7.08 MiB | 11.55 MiB/s, done. Resolving deltas: 100% (982/982), done. Submodule path '3party/fast_double_parser/benchmarks/dependencies/abseil-cpp': checked out 'd936052d32a5b7ca08b0199a6724724aea432309' Submodule path '3party/fast_double_parser/benchmarks/dependencies/double-conversion': checked out 'f4cb2384efa55dee0e6652f8674b05763441ab09' Submodule path '3party/fast_obj': checked out '1a8060257a96401a9555a476bd13c3a87502c9b5' Submodule path '3party/freetype/freetype': checked out '920c5502cc3ddda88f6c7d85ee834ac611bb11cc' Submodule 'dlg' (https://github.com/nyorain/dlg.git) registered for path '3party/freetype/freetype/subprojects/dlg' Cloning into '/Users/eivind/organicmaps/3party/freetype/freetype/subprojects/dlg'... remote: Enumerating objects: 1180, done. remote: Counting objects: 100% (170/170), done. remote: Compressing objects: 100% (106/106), done. remote: Total 1180 (delta 84), reused 102 (delta 41), pack-reused 1010 Receiving objects: 100% (1180/1180), 3.49 MiB | 9.20 MiB/s, done. Resolving deltas: 100% (655/655), done. Submodule path '3party/freetype/freetype/subprojects/dlg': checked out '72dfcc858c040c54a6a0b88fcb7e70ee186d3167' Submodule path '3party/gflags': checked out 'a738fdf9338412f83ab3f26f31ac11ed3f3ec4bd' Submodule path '3party/glm': checked out 'c834d06c2739f63e28e5665d4569dca9415e3891' Submodule path '3party/googletest': checked out '58d77fa8070e8cec2dc1ed015d66b454c8d78850' Submodule path '3party/harfbuzz/harfbuzz': checked out 'bc90b29b37fe3809f9e48aa7be08fbf2208e481a' git-lfs filter-process: git-lfs: command not found fatal: the remote end hung up unexpectedly fatal: Unable to checkout '680f521746a3bd6a86f25f25ee50a62d88b489cf' in submodule path '3party/icu/icu'```
rtsisyk reviewed 2024-06-18 09:04:52 +00:00

ok, it looks like that ICU requires git-lfs.

ok, it looks like that ICU requires git-lfs.
rtsisyk approved these changes 2024-06-18 09:05:04 +00:00
rtsisyk left a comment
Owner

Thanks for actualizing instructions!!

Thanks for actualizing instructions!!
biodranik (Migrated from github.com) reviewed 2024-06-18 09:17:36 +00:00
biodranik (Migrated from github.com) commented 2024-06-18 09:17:36 +00:00

git-lfs is not required to check out sources on my Mac and Ubuntu machines. What are the explanations?

@rtsisyk did you test it?

git-lfs is not required to check out sources on my Mac and Ubuntu machines. What are the explanations? @rtsisyk did you test it?
biodranik (Migrated from github.com) reviewed 2024-06-18 21:17:21 +00:00
biodranik (Migrated from github.com) commented 2024-06-18 21:17:21 +00:00

@eisams It works on the Ubuntu. Could it be that you've enabled git-lfs support in git/in your git config system-wide somehow?

$ git-lfs
Command 'git-lfs' not found, but can be installed with:
sudo apt install git-lfs

$ git clone --recurse-submodules https://github.com/organicmaps/organicmaps.git
Cloning into 'organicmaps'...
remote: Enumerating objects: 605697, done.
remote: Counting objects: 100% (30075/30075), done.
remote: Compressing objects: 100% (2528/2528), done.
remote: Total 605697 (delta 28120), reused 28218 (delta 27176), pack-reused 575622
Receiving objects: 100% (605697/605697), 6.60 GiB | 23.50 MiB/s, done.
Resolving deltas: 100% (425424/425424), done.
Updating files: 100% (14167/14167), done.
Submodule '3party/Vulkan-Headers' 
[LONG LOG SKIPPED]
Submodule path 'tools/twine': checked out 'a9a97d19c51e11ff677168c983c86988b08c4c81'
@eisams It works on the Ubuntu. Could it be that you've enabled git-lfs support in git/in your git config system-wide somehow? ``` $ git-lfs Command 'git-lfs' not found, but can be installed with: sudo apt install git-lfs $ git clone --recurse-submodules https://github.com/organicmaps/organicmaps.git Cloning into 'organicmaps'... remote: Enumerating objects: 605697, done. remote: Counting objects: 100% (30075/30075), done. remote: Compressing objects: 100% (2528/2528), done. remote: Total 605697 (delta 28120), reused 28218 (delta 27176), pack-reused 575622 Receiving objects: 100% (605697/605697), 6.60 GiB | 23.50 MiB/s, done. Resolving deltas: 100% (425424/425424), done. Updating files: 100% (14167/14167), done. Submodule '3party/Vulkan-Headers' [LONG LOG SKIPPED] Submodule path 'tools/twine': checked out 'a9a97d19c51e11ff677168c983c86988b08c4c81' ```
rtsisyk reviewed 2024-06-19 13:02:11 +00:00

git-lfs is not required to check out sources on my Mac and Ubuntu machines. What are the explanations?

@rtsisyk did you test it?

Do you think that the error message above from @eisams was fabricated?

Submodule path '3party/harfbuzz/harfbuzz': checked out 'bc90b29b37fe3809f9e48aa7be08fbf2208e481a'
git-lfs filter-process: git-lfs: command not found
fatal: the remote end hung up unexpectedly
fatal: Unable to checkout '680f521746a3bd6a86f25f25ee50a62d88b489cf' in submodule path '3party/icu/icu'```

> git-lfs is not required to check out sources on my Mac and Ubuntu machines. What are the explanations? > > @rtsisyk did you test it? Do you think that the error message above from @eisams was fabricated? > Submodule path '3party/harfbuzz/harfbuzz': checked out 'bc90b29b37fe3809f9e48aa7be08fbf2208e481a' > git-lfs filter-process: git-lfs: command not found > fatal: the remote end hung up unexpectedly > fatal: Unable to checkout '680f521746a3bd6a86f25f25ee50a62d88b489cf' in submodule path '3party/icu/icu'```
biodranik (Migrated from github.com) reviewed 2024-06-19 13:28:34 +00:00
biodranik (Migrated from github.com) commented 2024-06-19 13:28:34 +00:00

@rtsisyk I think this error appears due to some specific local environment setup. It does not reproduce on other machines, neither Mac, nor Linux. That is why it was absent in documentation.

@rtsisyk I think this error appears due to some specific local environment setup. It does not reproduce on other machines, neither Mac, nor Linux. That is why it was absent in documentation.
biodranik (Migrated from github.com) requested changes 2024-06-21 20:56:55 +00:00
biodranik (Migrated from github.com) left a comment

Yes, of course! Please remove lfs changes and we can merge it.

Yes, of course! Please remove lfs changes and we can merge it.
biodranik (Migrated from github.com) approved these changes 2024-06-29 18:24:56 +00:00
biodranik (Migrated from github.com) left a comment

Thanks!

Thanks!
This repo is archived. You cannot comment on pull requests.
No labels
Accessibility
Accessibility
Address
Address
Android
Android
Android Auto
Android Auto
Android Automotive (AAOS)
Android Automotive (AAOS)
API
API
AppGallery
AppGallery
AppStore
AppStore
Battery and Performance
Battery and Performance
Blocker
Blocker
Bookmarks and Tracks
Bookmarks and Tracks
Borders
Borders
Bug
Bug
Build
Build
CarPlay
CarPlay
Classificator
Classificator
Community
Community
Core
Core
CrashReports
CrashReports
Cycling
Cycling
Desktop
Desktop
DevEx
DevEx
DevOps
DevOps
dev_sandbox
dev_sandbox
Directions
Directions
Documentation
Documentation
Downloader
Downloader
Drape
Drape
Driving
Driving
Duplicate
Duplicate
Editor
Editor
Elevation
Elevation
Enhancement
Enhancement
Epic
Epic
External Map Datasets
External Map Datasets
F-Droid
F-Droid
Fonts
Fonts
Frequently User Reported
Frequently User Reported
Fund
Fund
Generator
Generator
Good first issue
Good first issue
Google Play
Google Play
GPS
GPS
GSoC
GSoC
iCloud
iCloud
Icons
Icons
iOS
iOS
Legal
Legal
Linux Desktop
Linux Desktop
Linux packaging
Linux packaging
Linux Phone
Linux Phone
Mac OS
Mac OS
Map Data
Map Data
Metro
Metro
Navigation
Navigation
Need Feedback
Need Feedback
Night Mode
Night Mode
NLnet 2024-06-281
NLnet 2024-06-281
No Feature Parity
No Feature Parity
Opening Hours
Opening Hours
Outdoors
Outdoors
POI Info
POI Info
Privacy
Privacy
Public Transport
Public Transport
Raw Idea
Raw Idea
Refactoring
Refactoring
Regional
Regional
Regression
Regression
Releases
Releases
RoboTest
RoboTest
Route Planning
Route Planning
Routing
Routing
Ruler
Ruler
Search
Search
Security
Security
Styles
Styles
Tests
Tests
Track Recording
Track Recording
Translations
Translations
TTS
TTS
UI
UI
UX
UX
Walk Navigation
Walk Navigation
Watches
Watches
Web
Web
Wikipedia
Wikipedia
Windows
Windows
Won't fix
Won't fix
World Map
World Map
No milestone
No project
No assignees
2 participants
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: organicmaps/organicmaps-tmp#8450
No description provided.