Un solveur de contraintes d'IA open source rapide, facile à utiliser pour les développeurs de logiciels
Les démarrages rapides d'OptaPlanner se trouvent dans le référentiel optaplanner-quickstarts.
Pour construire et exécuter à partir des sources :
$ mvn installation propre -Dquickly $ cd optaplanner-exemples $ mvn exécutable:java
Pour développer avec IntelliJ IDEA, Eclipse ou VSCode, ouvrez le pom.xml
racine en tant que nouveau projet et configurez une configuration Exécuter/Déboguer comme ceci :
Type : Candidature
Classe principale : org.optaplanner.examples.app.OptaPlannerExamplesApp
Options de VM : -Xmx2G -server
(mémoire nécessaire uniquement lors de l'utilisation des grands ensembles de données dans les exemples)
Arguments du programme : (aucun)
Répertoire de travail : $MODULE_DIR$
(doit être résolu dans le répertoire optaplanner-examples)
Utiliser le chemin de classe du module : optaplanner-examples
Il s'agit d'un projet open source, et vous êtes plus que bienvenu pour contribuer ❤️ !
Si vous débutez avec OptaPlanner et souhaitez contribuer, jetez un œil à nos problèmes de démarrage. Ils sont spécifiquement choisis pour être plus faciles pour les nouveaux contributeurs.
Si vous souhaitez contribuer ou démarrer une discussion d'opinion, rejoignez notre discussion ou envoyez un e-mail directement à [email protected].
Si vous souhaitez soumettre un problème, consultez le projet OptaPlanner Jira.
Chaque modification doit être soumise via une pull request (PR) GitHub. OptaPlanner utilise l'intégration continue (CI). L'OptaPlanner CI exécute des vérifications auprès de votre succursale après avoir soumis le PR pour garantir que votre PR n'introduit pas d'erreurs. Si le CI identifie un problème potentiel, nos sympathiques responsables des relations publiques vous aideront à le résoudre.
Forkez-le (https://github.com/kiegroup/optaplanner).
Créez votre branche de fonctionnalités : ( git checkout -b feature
).
Validez vos modifications avec un commentaire : ( git commit -am 'Add some feature'
).
Poussez vers la branche vers GitHub : ( git push origin feature
).
Créez une nouvelle demande d'extraction.
Votre code est automatiquement formaté selon les conventions d'importation et de style de code lors de chaque build Maven. Les vérifications CI appliquent également ces conventions, alors assurez-vous de construire votre projet avec maven avant de créer votre PR :
mvn installation propre
Pour plus d’informations sur la configuration des vérifications de style de code, consultez les instructions de configuration de l’EDI.
Utilisez l'une des méthodes suivantes pour créer votre projet OptaPlanner :
build-fast : mvn clean install -Dquickly
toutes les vérifications et analyses de code (~ 1 min)
? build-normally : mvn clean install
exécute des tests, vérifie le style de code, ignore la documentation (~ 17 min)
? build-doc : mvn clean install
sur optaplanner/optaplanner-docs
crée la documentation asciidoctor target/optaplanner-docs-*/html_single/index.html
(~ 2 min)
? build-all : mvn clean install -Dfull
exécute toutes les vérifications + crée des fichiers de documentation et de distribution (~ 20 min)
Vous pouvez vérifier l'état CI des référentiels OptaPlanner à partir de la page Web État de la chaîne.
Toutes les tâches Jenkins se trouvent dans le dossier OptaPlanner : https://eng-jenkins-csb-business-automation.apps.ocp-c1.prod.psi.redhat.com/job/KIE/job/optaplanner
Emplois Jenkins CI intéressants (nécessité d'un accès VPN) :
Mettre à jour la version de Quarkus
Mettre à jour la version de Drools
Pipeline de versions (uniquement disponible sur les branches de versions)
Pipeline post-version (uniquement disponible sur les branches de version)