Kit Pengembangan Perangkat Lunak (SDK) Optimization Solver, bernama MindOpt, adalah solver lokal yang dijalankan pada mesin Anda sendiri. Halaman ini menjelaskan cara mengunduh paket yang sesuai untuk platform Anda, menginstalnya, mengonfigurasi lisensi, serta menambahkan dukungan khusus bahasa untuk Java atau Python.
Dengan mengunduh SDK, Anda menyetujui Ketentuan Layanan Optimization Solver.
Instalasi cepat hanya untuk Python atau Java
Jika Anda hanya memerlukan pustaka Python, instal menggunakan pip:
pip install mindoptpyJika Anda hanya memerlukan pustaka Java (V2.1 dan yang lebih baru), tambahkan dependensi Maven ke file pom.xml Anda. Lihat Instal dukungan Java untuk opsi classifier.
Kedua pendekatan ini melewati instalasi penuh. Untuk menggunakan solver berbasis command line, API C, C++, C#, atau MATLAB, atau untuk menggunakan beberapa API bahasa secara bersamaan, unduh paket instalasi lengkap yang dijelaskan di bawah ini.
Prasyarat
Sebelum memulai, pastikan Anda telah memiliki:
Sistem operasi yang didukung (lihat Persyaratan sistem)
Hak akses administrator atau hak tulis yang cukup pada mesin target
Akun Alibaba Cloud (diperlukan untuk autentikasi cloud)
Unduh SDK
Versi terbaru: V2.3.0 (dirilis 2026-02-02).
API pada V0.x dan V2.x sebagian besar tidak kompatibel. Rujuk dokumentasi API untuk versi yang Anda instal.
| Platform | Arsitektur | V2.3.0 | V0.25.1 |
|---|---|---|---|
| Linux | linux64x86 | File: mindopt-install-linux64x86-2.3.0.sh — Setujui persyaratan dan unduh | File: mindopt-install-linux64x86-0.25.1.sh — Setujui persyaratan dan unduh |
| Linux | linux64aarch | File: mindopt-install-linux64aarch-2.3.0.sh — Setujui persyaratan dan unduh | File: mindopt-install-linux64aarch-0.25.1.sh — Setujui persyaratan dan unduh |
| Windows | windows64 | File: mindopt-2.3.0.msi — Setujui persyaratan dan unduh | File: mindopt-0.25.1.msi — Setujui persyaratan dan unduh |
| macOS | osx64x86 (Intel) | File: mindopt-install-osx64x86-2.3.0.sh — Setujui persyaratan dan unduh | File: mindopt-install-osx64x86-0.25.1.sh — Setujui persyaratan dan unduh |
| macOS | osx64aarch (Apple Silicon) | File: mindopt-install-osx64aarch-2.3.0.sh — Setujui persyaratan dan unduh | File: mindopt-install-osx64aarch-0.25.1.sh — Setujui persyaratan dan unduh |
Untuk catatan perubahan dan versi lama, lihat Riwayat unduhan.
Persyaratan sistem
Sistem operasi
| Sistem operasi | Versi minimum |
|---|---|
| Windows | Windows 10 atau yang lebih baru |
| Linux x86_64 | Glibc >= 2.14 |
| Linux aarch64 | Glibc >= 2.17 |
| macOS x86_64 | macOS 11.0 atau yang lebih baru |
| macOS arm64 | macOS 12.0 atau yang lebih baru |
Versi bahasa dan kompilator
| Bahasa | Versi / kompilator yang didukung |
|---|---|
| C | Visual Studio 2019 atau yang lebih baru, GCC 4.9 atau yang lebih baru, Clang++ |
| C++ | Visual Studio 2019 atau yang lebih baru, GCC 4.9 atau yang lebih baru, Clang++ |
| C# | .NET SDK 8.0 atau yang lebih baru |
| Python | 3.8, 3.9, 3.10, 3.11, 3.12, 3.13 |
| Java | JDK 1.8 atau yang lebih baru |
| MATLAB | MATLAB 2021b atau yang lebih baru |
Instal SDK
Sebelum menginstal, hapus atau cadangkan versi sebelumnya. Lihat Uninstal dan instal ulang.
Anda juga dapat mengikuti Ikhtisar video.
Windows
Klik ganda file instalasi .msi dan ikuti petunjuk pada layar.
Untuk menginstal bagi semua pengguna, jalankan Command Prompt sebagai administrator, pindah ke folder yang berisi installer, lalu jalankan file tersebut dari sana.
Linux
Tidak yakin arsitektur mana yang Anda gunakan? Jalankan uname -m. Output x86_64 berarti gunakan installer x86; aarch64 berarti gunakan installer ARM.
Jalankan perintah berikut dan ikuti petunjuknya:
mindoptDocker
Tambahkan baris berikut ke Dockerfile Anda:
# Pengguna admin digunakan sebagai contoh.
RUN cd /home/admin/mindopt/ && \
bash mindopt-install-linux64x86-2.3.0.sh --target /home/admin/mindopt && \
rm -rf mindopt-install-linux64x86-2.3.0.sh
# Atur variabel lingkungan MindOpt.
ENV MINDOPT_HOME /home/admin/mindopt/2.3.0
ENV PATH $MINDOPT_HOME/linux64-x86/bin:$PATH
ENV LD_LIBRARY_PATH $MINDOPT_HOME/linux64-x86/lib:$LD_LIBRARY_PATHUntuk instalasi Docker V0.x.x saja, tambahkan juga:
# MDO_NATIVE_LIBRARY diperlukan untuk SDK Java di V0.x.x. Tidak diperlukan untuk V1.0.0 atau yang lebih baru.
ENV MDO_NATIVE_LIBRARY $MINDOPT_HOME/linux64-x86/lib/libmindopt.so.0.25.1macOS
Jalankan perintah berikut dan ikuti petunjuknya:
# Sistem Intel (x86_64)
bash mindopt-install-osx64x86-2.3.0.sh
# Sistem Apple Silicon (arm64)
bash mindopt-install-osx64aarch-2.3.0.shStruktur direktori setelah instalasi
Setelah proses instalasi selesai, direktori instalasi berisi hal-hal berikut:
| Path | Deskripsi |
|---|---|
2.3.0/ | Folder Root yang dinamai sesuai versi yang diinstal. Beberapa versi dapat berdampingan dalam direktori induk yang sama. |
<platform>/ | Subfolder yang berisi file eksekusi, pustaka tautan dinamis, dan file terkait. Nama folder mencerminkan OS dan arsitektur Anda: win64-x86, linux64-x86, osx64-x86, linux64-aarch, atau osx64-aarch. |
examples/ | Contoh kode untuk berbagai bahasa, alat pemodelan, dan data masukan contoh di subfolder data/. Mulailah dari sini. |
docs/ | Readme.txt, Perjanjian Lisensi Pengguna Akhir (EULA), dan dokumen lainnya. |
fl_client.ini | File autentikasi yang Anda buat pada langkah berikutnya. |

Verifikasi instalasi
Periksa variabel lingkungan
Windows: Installer secara otomatis menambahkan MINDOPT_HOME dan Path. Untuk beralih antar versi yang diinstal, perbarui nilai MINDOPT_HOME.

Linux dan macOS: Installer menambahkan source ~/.mdo_profile ke ~/.bashrc dan ~/.zshrc. Perubahan akan berlaku setelah Anda memulai ulang terminal.
Untuk menerapkannya segera tanpa memulai ulang:
cat ~/.mdo_profile # lihat pengaturan saat ini
source ~/.mdo_profileUntuk beralih antar versi yang diinstal, edit langsung ~/.mdo_profile:
nano ~/.mdo_profileDalam kontainer Docker, gunakan export untuk memeriksa variabel tersebut.
Jalankan uji coba cepat
Setelah memuat variabel lingkungan, jalankan mindopt di command line:
mindoptInstalasi yang berhasil akan mencetak informasi versi dan penggunaan ke terminal, seperti output yang ditampilkan di sini:

Pemecahan masalah
Error izin: Jika mindopt gagal dijalankan, perbaiki izin eksekusi:
# Linux
chmod u+x $MINDOPT_HOME/linux64-x86/bin/mindopt
# macOS
chmod u+x $MINDOPT_HOME/osx64-x86/bin/mindoptBlokir keamanan macOS: macOS mungkin mencegah binary dijalankan karena pemeriksaan keamanan developer. Di Security & Privacy, klik Allow Anyway.

Untuk masalah lainnya, lihat bagian Masalah instalasi dalam FAQ.
Konfigurasi lisensi
MindOpt memerlukan file lisensi untuk dijalankan. Pilih salah satu dari dua metode autentikasi berikut:
| Autentikasi cloud (disarankan) | Autentikasi offline | |
|---|---|---|
| Cara kerja | Kunci lisensi terikat pada Akun Alibaba Cloud Anda; koneksi internet hanya diperlukan untuk autentikasi | File lisensi terikat pada ID mesin tertentu; sepenuhnya offline |
| Paling cocok untuk | Sebagian besar pengguna; terutama saat digunakan di beberapa mesin | Lingkungan air-gapped atau penerapan single-machine |
| Multi-machine | Satu kunci berlaku di beberapa mesin | Hanya satu mesin |
| Perpanjangan | Perpanjang melalui konsol tanpa mengganti file lisensi; pengingat SMS sebelum masa berlaku habis | Beli lisensi baru |
Saat autentikasi, MindOpt mencarimindopt.licterlebih dahulu, lalufl_client.ini, berdasarkan pengaturan variabel lingkungan. MindOpt memvalidasi file pertama yang ditemukan. Nama file lisensi bersifat tetap dan tidak dapat diubah.
Opsi 1: Autentikasi cloud (disarankan)
Ikuti langkah-langkah dalam Konfigurasi Akun Alibaba Cloud untuk autentikasi untuk mendapatkan kunci lisensi dan membuat file lisensi fl_client.ini. Solver dijalankan secara lokal pada mesin Anda. Koneksi internet hanya diperlukan untuk autentikasi — tidak ada informasi lain yang diunggah.
Opsi 2: Autentikasi offline
Mulai tahun 2024, beli lisensi autentikasi lokal dari konsol. Lisensi ini terikat pada sidik jari mesin (ID mesin) dan mendukung penggunaan offline, single-machine, dengan jumlah konkuren tak terbatas. Untuk petunjuk mendapatkan sidik jari mesin, lihat konsolCara mendapatkan sidik jari mesin untuk lisensi offline fixed-machine.
Tetapkan lokasi file lisensi
Disarankan: Tetapkan variabel lingkungan MINDOPT_LICENSE_PATH ke folder yang berisi file lisensi.
Linux dan macOS:
export MINDOPT_LICENSE_PATH=$HOME/mindoptWindows — tetapkan variabel lingkungan di System Properties:

Untuk detail lebih lanjut, lihat Konfigurasi lisensi.
Lokasi default (jika `MINDOPT_LICENSE_PATH` tidak ditetapkan):
| OS | Jalur Bawaan |
|---|---|
| Windows | C:\Users\<username>\mindopt\fl_client.ini |
| Linux | ~/mindopt/fl_client.ini |
| macOS | ~/mindopt/fl_client.ini |
Instal dukungan Java
Selesaikan instalasi dasar di atas sebelum menginstal dukungan Java. SDK Java bergantung pada pustaka tautan dinamis solver.
Pilih metode yang sesuai dengan versi SDK Anda:
V2.1 dan yang lebih baru — dependensi Maven (disarankan)
Tambahkan dependensi berikut ke pom.xml Anda. Atur classifier agar sesuai dengan platform Anda:
<dependency>
<groupId>com.alibaba.damo</groupId>
<artifactId>mindoptj</artifactId>
<version>2.1.0-SNAPSHOT</version>
<classifier>osx-x64</classifier>
<!-- macOS arm64 : osx-aarch -->
<!-- linux arm64 : linux-aarch -->
<!-- linux x86 : linux-x64 -->
<!-- windows : win-x64 -->
<!-- all platforms: portable -->
<type>jar</type>
</dependency>V1.0 dan yang lebih baru — JAR bawaan
Paket instalasi menyertakan mindoptj.jar di <MDOHOME>/<VERSION>/<PLATFORM>/lib/mindoptj.jar. Rujuk langsung dalam pom.xml:
<dependency>
<groupId>com.alibaba.damo</groupId>
<artifactId>mindoptj</artifactId>
<version>2.0.0</version>
<scope>system</scope>
<systemPath>${env.MINDOPT_HOME}/osx64-x86/lib/mindoptj.jar</systemPath>
</dependency>V0.x.x — dependensi Maven
<dependency>
<groupId>com.alibaba.damo</groupId>
<artifactId>mindoptj</artifactId>
<version>[0.24.0, 1.0.0)</version>
</dependency>Beberapa IDE (misalnya, CLion) memblokir variabel lingkungan terkait rpath saat runtime, menyebabkan error ketika program mencari pustaka dinamis. Tentukan path pustaka secara manual dalam konfigurasi run IDE Anda. Untuk CLion di macOS, tambahkan berikut ini di Run/Debug Configurations: DYLD_LIBRARY_PATH=<MDOHOME>/<VERSION>/<PLATFORM>/lib
Instal dukungan Python
Mulai dari V0.24.1, pip install mindoptpy menyediakan pustaka Python mandiri dengan lisensi terintegrasi (berlaku dari 2023-01-01 hingga 2025-02-28). Instalasi ini hanya mencakup pustaka Python — tidak termasuk solver command-line, API C/C++, atau alat pemodelan. Untuk fitur tersebut, lakukan instalasi lengkap seperti di atas.
Setelah instalasi lengkap, masuk ke folder pustaka Python dan instal:
cd <MDOHOME>/<VERSION>/<PLATFORM>/lib/python
pip install .Mulai dari V2.1, Python 3.6 dan 3.7 tidak lagi didukung. Untuk solusi error impor modul mindoptpy atau petunjuk instalasi detail, lihat Panduan Pengguna.Uninstal dan instal ulang
Uninstal
Windows: Buka Control Panel > Programs and Features, temukan versi MindOpt, lalu klik kanan untuk meng-uninstal. Setiap versi yang diinstal muncul sebagai entri terpisah. Jika Anda menginstal sebagai administrator, uninstaller mungkin tidak memiliki izin untuk menghapus variabel lingkungan MINDOPT_HOME dan Path — hapus secara manual atau jalankan uninstaller sebagai administrator.
Linux dan macOS:
Hapus direktori instalasi (misalnya,
$HOME/mindopt).Hapus baris
source ~/.mdo_profiledari~/.bashrcdan~/.zshrc, lalu hapus~/.mdo_profile.
API Python:
pip3 uninstall mindoptpyJika Anda berencana menginstal ulang nanti, cadangkan file lisensi Anda sebelum menghapus direktori instalasi. Lokasi default lisensi:$HOME/mindopt(Linux/macOS) danC:\Users\<username>\mindopt(Windows). Menjalankan contoh perintah mungkin menghasilkan file hasil.basdan.soldi direktori instalasi — hapus sesuai kebutuhan.
Instal ulang
Beberapa versi SDK dapat berdampingan dalam folder terpisah. Tetapkan variabel lingkungan untuk versi yang ingin Anda gunakan — tidak diperlukan perubahan pada file lisensi.
Windows: Klik ganda installer. Pengaturan variabel lingkungan baru akan menimpa pengaturan sebelumnya. Untuk beralih antar versi, perbarui direktori dalam variabel lingkungan MINDOPT_HOME.
Linux dan macOS: Ikuti langkah instalasi di atas. Lalu perbarui path versi dalam ~/.mdo_profile atau dalam ~/.bashrc/~/.zshrc.
Setelah menginstal ulang, tutup dan buka kembali jendela command prompt agar variabel lingkungan baru berlaku.
Langkah selanjutnya
Baru menggunakan MindOpt? Ikuti Contoh cepat penyelesaian masalah dalam panduan Memulai.
Untuk dokumentasi solver lengkap, lihat Manual Pengguna Solver.