Wstęp
Z tego przewodnika dowiesz się, jak tworzyć kompilacje przy użyciu źródłowych narzędzi LUB-Tools z obsługą C++ w systemie macOS.
Jeśli nie chcesz modyfikować kodu źródłowego ani używać rozwiązań innej firmy za pomocą narzędzi LUB, zalecamy instalację pakietu.
Chociaż te instrukcje mogą też działać w innych wersjach systemu macOS, przetestowaliśmy je tylko na komputerach spełniających te wymagania:
- MacOS 13.0.1 (Ventura) Intel 64-bitowy (x86_64)
- MacOS 13.0.1 (Ventura) M1 (arm64)
Wymagania wstępne
W kolejnych sekcjach opisano wymagania wstępne instalacji narzędzi LUB.
Narzędzia wiersza poleceń Xcode
Musisz zainstalować narzędzia wiersza poleceń Xcode. Aby to zrobić, otwórz terminal w aplikacji /Applications/Utilities/
i wpisz:
xcode-select --install
Kliknij „Zainstaluj”, aby pobrać i zainstalować narzędzia wiersza poleceń Xcode. Nie musisz pobierać Xcode z App Store. Jeśli masz wolne połączenie internetowe, może to potrwać kilka minut.
Sprawdź, czy udało Ci się zainstalować narzędzia wiersza poleceń Xcode:
xcode-select -p
Zobaczysz, że:
/Library/Developer/CommandLineTools
Domowe
Aby zainstalować pozostałe wymagania wstępne, najpierw zainstaluj „brakującego menedżera pakietów dla systemu macOS”, zwanego też Homebrew. Aby to zrobić, otwórz okno terminala i wpisz:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew update
Aby sprawdzić, czy udało Ci się zainstalować piwo:
brew --version
Zobaczysz, że:
Homebrew 1.6.9-8-g25542d7
Homebrew/homebrew-core (git revision 0e0c84; last commit 2018-06-20)
Narzędzia C++
Aby zainstalować narzędzia C++, otwórz okno terminala i wpisz:
brew install cmake wget pkg-config
Pobieranie kodu źródłowego
W GitHub istnieją 2 różne gałęzie kodu źródłowego OR-Tools: stable
i main
.
Gałąź stable
została dokładnie przetestowana i powinna działać prawidłowo na wszystkich obsługiwanych platformach.
Gałąź main
to miejsce, w którym wprowadzono najnowsze aktualizacje i ulepszenia. Jest bardziej aktualna, ale mniej stabilna.
Pobieranie stabilnego kodu źródłowego
Stabilny kod źródłowy dla OR-Tools możesz uzyskać na jeden z tych sposobów:
Skopiuj gałąź
stable
, wpisując:git clone https://github.com/google/or-tools
Pobierz najnowszą wersję w skompresowanym pliku, klikając przycisk
Clone or download
na GitHub.
Pobierz główny kod źródłowy
Aby pobrać kod źródłowy z gałęzi main
, wpisz:
git clone -b main https://github.com/google/or-tools
Pobieranie poprzednich wersji
Kod źródłowy poprzednich wersji możesz pobrać na następujące sposoby:
- Pobierz poprzednią wersję ze strony wersji na GitHubie.
Zakładając, że masz już utworzone repozytorium lokalne (do
git clone
), możesz sprawdzić konkretną wersję za pomocą tagu Git. Aby na przykład pracować z wersją 9.9 zamiast gałęzimain
, wpisz w lokalnym repozytorium te polecenia:git fetch --all --tags --prune
git checkout tags/v9.9 -v v9.9
Konfigurowanie kompilacji
Przed utworzeniem narzędzi LUB musisz skonfigurować generator systemu kompilacji CMake.
Otwórz terminal i przejdź do katalogu, z którego zostały wyodrębnione pliki. Potem wpisz:
cmake -S . -B build -DBUILD_DEPS=ON
Więcej informacji znajdziesz w dokumentacji CMake.
Korzystanie z SCIP
Od wersji 7.8 rozwiązanie SCIP jest teraz zintegrowane, więc nie musisz instalować go ręcznie.
Korzystanie z Gurobi
Usługa Gurobi jest teraz wstępnie zintegrowana. W razie potrzeby w czasie działania narzędzi OR-Tools wyszuka zasoby udostępniane Gurobi w domyślnej ścieżce instalacji instalatorów Gurobi w systemie MAC OS X i Windows lub za pomocą zmiennej środowiskowej GUROBI_HOME
.
Korzystanie z opcjonalnego rozwiązania MIP innej firmy
Możesz też używać LUB z dowolnym z tych opcjonalnych rozwiązań MIP innych firm, których obsługa domyślnie jest wyłączona:
- CPLEX
- GLPK (tylko Linux i macOS)
- Rozwiązanie XPRESS
Więcej informacji znajdziesz w tej dokumentacji.
Tworzenie kodu źródłowego
Aby utworzyć kod źródłowy, otwórz terminal i przejdź do katalogu, z którego zostały wyodrębnione pliki. Następnie wpisz to polecenie, aby skompilować OR-Tools:
cmake --build build --config Release --target ALL_BUILD -j -v
Więcej informacji znajdziesz w dokumentacji CMake.
Testowanie kodu źródłowego
Aby sprawdzić, czy wszystko działa poprawnie, wpisz:
cmake --build build --config Release --target RUN_TESTS -v
Uruchamiają się przykłady z operatora LUB. Jeśli wszystkie przykłady się uruchomią, możesz zacząć korzystać z OR-Tools.
Czyszczenie plików kompilacji
Jeśli musisz ponownie zainstalować OR-Tools, polecenie:
rm -r build
usuwa wszystkie skompilowane zależności. Może to być przydatne podczas przywracania ustawień fabrycznych.
Następnie ponownie wpisz polecenia:
cmake -S . -B build -DBUILD_DEPS=ON
cmake --build build --config Release --target ALL_BUILD -j -v
Instalowanie narzędzi OR-Tools w swoim systemie operacyjnym
Możesz zainstalować OR-Tools dla C++ w swoim systemie operacyjnym, wpisując:
cmake --build build --config Release --target install -v