MacOS'te kaynaktan VEYA .Net'ten geliştirme

Giriş

Bu kılavuzda, MacOS'te .Net desteğiyle kaynak VEYA Araçları'ndan nasıl derleme yapılacağı açıklanmaktadır.

Kaynak kodunu değiştirmeyi veya OR-Tools ile bir üçüncü taraf çözücü kullanmayı planlamıyorsanız paket yüklemesini öneririz.

Bu talimatlar diğer MacOS varyantlarında da işe yarayabilecek olsa da, talimatları yalnızca aşağıdaki gereksinimleri karşılayan makinelerde test ettik:

  • MacOS 13.0.1 (Ventura) Intel 64 bit (x86_64)
  • MacOS 13.0.1 (Ventura) M1 (arm64)

Ön koşullar

Aşağıdaki bölümlerde VEYA Araçları'nı yüklemeye ilişkin ön koşullar açıklanmaktadır.

Xcode Komut Satırı Araçları

Xcode Komut Satırı Araçları'nı yüklemeniz gerekir. Bunun için /Applications/Utilities/ içindeki Terminal'i açın ve şunu girin:

xcode-select --install

Xcode Komut Satırı Araçlarını indirip yüklemek için "Yükle"yi tıklayın. App Store'dan "Xcode"u almanıza gerek yoktur. İnternet bağlantınız yavaşsa bu işlem birkaç dakika sürebilir.

Xcode Komut Satırı Araçlarını başarıyla yüklediğinizi doğrulayın:

xcode-select -p

Aşağıdaki bilgileri görürsünüz:

/Library/Developer/CommandLineTools

Evde Bira

Kalan ön koşulları yüklemek için ilk olarak Homebrew olarak bilinen "macOS için eksik paket yöneticisini" yüklemenizi öneririz. Bunun için bir terminal penceresi açın ve şunu girin:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew update

Demleme işlemini başarıyla yüklediğinizi doğrulamak için:

brew --version

Aşağıdaki bilgileri görürsünüz:

Homebrew 1.6.9-8-g25542d7
Homebrew/homebrew-core (git revision 0e0c84; last commit 2018-06-20)

C++ araçları

C++ araçlarını yüklemek için bir terminal penceresi açın ve şunu girin:

brew install cmake wget pkg-config

SWIG aracı

SWIG aracını yüklemek için bir terminal penceresi açın ve şunu girin:

brew install swig

.Net 6.0 SDK'sı

.Net 6.0 SDK'sını yüklemeniz gerekir.

Homebrew'u yükledikten sonra bir terminal penceresi açıp dotnet-sdk paketini yükleyerek şu komutu girebilirsiniz:

brew cask install dotnet-sdk

Aşağıdaki komutu kullanarak dotnet cli'nin doğru şekilde yüklenip yüklenmediğini test edebilirsiniz:

dotnet --info

Kaynak kodu indirme

GitHub'da OR-Tools kaynak kodunun iki ayrı dalı vardır: stable ve main.

stable dalı kapsamlı bir şekilde test edilmiş olup desteklenen tüm platformlarda sorunsuz bir şekilde çalışacaktır.
main dalı, en son güncellemelerin ve iyileştirmelerin uygulandığı yerdir; daha güncel ancak daha az kararlıdır.

Kararlı kaynak kodunu indirin

OR-Tools için kararlı kaynak kodunu aşağıdaki yöntemlerden biriyle alabilirsiniz:

  • Aşağıdakileri girerek stable dalını klonlayın:

    git clone https://github.com/google/or-tools

  • En son sürümü sıkıştırılmış bir dosyada indirmek için GitHub'daki Clone or download düğmesini tıklayın.klon veya indir düğmesinin resmi

Ana kaynak kodunu indirin

main dalından kaynak kodunu almak için şunu girin:

git clone -b main https://github.com/google/or-tools

Önceki sürümleri indir

Önceki sürümlerin kaynak kodunu aşağıdaki yöntemlerden biriyle alabilirsiniz:

  • GitHub sürüm sayfasından önceki bir sürümü indirin.

  • Daha önce yerel bir depo oluşturduğunuzu varsayarsak (git clone tarafından), Git etiketi kullanarak belirli bir sürüme göz atabilirsiniz. Örneğin, main dalı yerine v9.9 sürümüyle çalışmak için yerel deponuza aşağıdaki komutları girin:

    git fetch --all --tags --prune
git checkout tags/v9.9 -v v9.9

Derlemeyi yapılandırma

OR araçları derlemeden önce, CMake derleme sistemi oluşturma aracını yapılandırmanız gerekir.

Bir terminal penceresi açın ve dosyaları çıkardığınız dizine gidin. Ardından şu komutu girin:

cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_DOTNET=ON

Ayrıntılar için CMake dokümanlarına göz atın.

SCIP kullanma

SCIP 7.8 sürümünden itibaren artık entegre edilmiştir; bu sayede manuel olarak yüklemeniz gerekmez.

Gurobi'yi kullanma

Gurobi artık önceden entegre edildi. Gerektiğinde, OR-Tools çalışma zamanında MAC OS X ve Windows'daki Gurobi yükleyicilerinin varsayılan yükleme yolunda veya GUROBI_HOME ortam değişkenini kullanarak Gurobi paylaşılan kitaplığını arar.

İsteğe bağlı üçüncü taraf MIP çözücü kullanma

VEYA Araçları'nı, desteği varsayılan olarak devre dışı olan aşağıdaki isteğe bağlı üçüncü taraf MIP çözümlerinden biriyle de kullanabilirsiniz:

Ayrıntılar için lütfen bu belgelere göz atın.

Kaynak kodunu oluşturma

Kaynak kodunu oluşturmak için bir terminal penceresi açın ve dosyaları çıkardığınız dizine gidin. Ardından VEYA Araçları'nı derlemek için aşağıdaki komutu girin:

cmake --build build --config Release --target ALL_BUILD -j -v

Ayrıntılar için CMake dokümanlarına göz atın.

Kaynak kodu test etme

Aşağıdakileri girerek her şeyin düzgün çalışıp çalışmadığını kontrol edebilirsiniz:

cmake --build build --config Release --target RUN_TESTS -v

Bu komut, VEYA Araçları ile ilgili örnekleri çalıştırır. Tüm örnekler başarıyla çalışırsa VEYA Araçları'nı kullanmaya hazırsınız demektir.

Derleme dosyalarını temizleme

OR-Tools'u yeniden yüklemeniz gerekirse komut:

rm -r build

işlevi, derlenen tüm bağımlılıkları kaldırır. Bu, cihazı temiz bir duruma sıfırlamak için yararlı olabilir.

Daha sonra komutları tekrar girin:

cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_DOTNET=ON


cmake --build build --config Release --target ALL_BUILD -j -v

OR-Tools'u işletim sisteminize yükleme

Aşağıdakileri girerek işletim sisteminize .Net için OR-Tools'u yükleyebilirsiniz:

cmake --build build --config Release --target install -v