Tu peux juste m'appeler Choco.
Action github |
---|
Venez vous joindre à la conversation sur Chocolatey dans notre salle de chat communautaire.
Veuillez vous assurer d'avoir lu et d'accord avec l'étiquette concernant la communication.
Installation de fosses chocolatées montrant l'achèvement de l'onglet et refreshenv
(un moyen de mettre à jour les variables d'environnement sans redémarrer votre coquille):
Chocolatey Pro montrant un cache de téléchargement CDN privé et une protection contre le scan de virus:
Si vous êtes un utilisateur open source demandant un soutien, n'oubliez pas que la plupart des gens de la communauté chocolatée sont des bénévoles qui ont des vies en dehors de l'open source et ne sont pas payés pour vous assurer que les choses fonctionnent pour vous, alors soyez prévenant du temps des autres lorsque vous êtes demander des choses. Beaucoup d'entre nous ont également des familles qui ont également besoin de temps et n'ont que beaucoup de temps à donner quotidiennement. Un peu de considération et de patience peut aller très loin. Après tout, vous utilisez un très bon outil sans coût. Ce n'est peut-être pas parfait (encore), et nous le savons.
Si vous utilisez une édition commerciale de Chocolatey, vous avez des termes différents! Veuillez consulter le soutien.
Veuillez voir les documents
Donner choco.exe -?
un coup (ou choco.exe -h
). Pour des commandes spécifiques, ajoutez la commande, puis le commutateur d'aide par exemple choco.exe install -h
.
Apache 2.0 - Voir les fichiers de licence et de préavis.
Observez l'aide suivante pour soumettre un problème:
Prérequis:
Soumettre un billet:
-dv
ou --debug --verbose
. Vous pouvez soumettre cela avec le problème ou créer un GIST et le lier.$env:ChocolateyInstalllog
. Vous pouvez récupérer la sortie de journal spécifique à partir de là afin que vous n'ayez pas à capturer ou à rediriger la sortie de l'écran. Veuillez limiter le montant inclus à l'exécution de la commande (le journal est ajouté à chaque commande).log.sh
) et un lien vers l'essentiel à partir du problème. N'hésitez pas à le créer comme secret afin qu'il ne se remplisse pas contre vos GIST publics. Toute personne ayant un lien direct peut toujours se rendre à Secret GIST. Si vous incluez accidentellement des informations secrètes dans votre GIST, veuillez les supprimer et en créer une nouvelle (l'historique de l'essentiel peut être vu par n'importe qui) et mettre à jour le lien dans le billet (l'historique du numéro n'est conservé que par e-mail - la suppression de l'escroc garantit que non on peut y arriver). L'utilisation des GIST de cette façon empêche également les secrets accidentels d'être partagés dans le billet en premier lieu.Si vous souhaitez contribuer du code ou aider à écraser un bug ou deux, c'est génial. Veuillez vous familiariser avec la contribution.
Ce projet utilise un fichier .EditorConfig afin d'aider à maintenir la cohérence du code. Les erreurs et les avertissements produits en ne suivant pas ces conventions définies seront à l'avenir appliquées au moment de la construction, alors assurez-vous que vos contributions adhèrent aux règles définies et ne produisent aucun avertissement ou erreurs dans Visual Studio.
Les engageurs, vous devriez être très familier avec les engageurs.
Il existe un fichier build.bat
/ build.sh
qui crée un fichier généré nécessaire nommé SolutionVersion.cs
. Il doit être exécuté au moins une fois avant que Visual Studio ne se construise.
Prérequis:
Voici un ensemble minimum d'exigences pour terminer avec succès le processus de construction:
dotnet tool install
) Il existe un fichier setup.ps1
à la racine de ce référentiel, qui peut être utilisé pour installer tout ce qui précède.
Processus de construction:
build.bat
. Important
On suppose que la CLI chocolatée est installée sur la machine où vous utilisez la construction, car cela est nécessaire pour générer le paquet de chocolat final. Si nécessaire, vous pouvez ignorer la création des packages chocolatés en utilisant l'option --shouldRunChocolatey
, c'est-à-dire .build.bat --shouldRunChocolatey=false
L'exécution de la construction sur Windows devrait produire un artefact testé et prêt à être utilisé.
docker/Dockerfile.linux
pour la version actuellement recommandée de Mono.~/.profile
(ou à un autre fichier source DOT pertinent): # Mono
# http://www.michaelruck.de/2010/03/solving-pkg-config-and-mono-35-profile.html
# https://cloudgen.wordpress.com/2013/03/06/configure-nant-to-run-under-mono-3-06-beta-for-mac-osx/
export PKG_CONFIG_PATH=/opt/local/lib/pkgconfig:/Library/Frameworks/Mono.framework/Versions/Current/lib/pkgconfig: $PKG_CONFIG_PATH
chmod +x * .sh
./build.sh
.L'exécution de la construction sur Mono produit un artefact similaire à Windows mais peut avoir plus de bords rugueux. Vous pouvez obtenir un échec ou deux dans le script de construction qui peut être ignoré en toute sécurité.
La base de code CLI chocolatée contient un certain nombre de tests différents, y compris des tests d'unité, d'intégration et de bout en bout. Ceux-ci sont tous documentés dans le fichier Test.md.
Les tests d'unité et d'intégration sont des tests Nunit, qui peuvent être exécutés directement dans Visual Studio, ou dans le cadre du processus de construction.
Les tests de bout en bout utilisent Pester comme cadre de test. Étant donné que ces tests ont le potentiel d'apporter des modifications à votre système, nous vous recommandons d'utiliser le fichier Vagrant fourni pour exécuter ces tests dans une machine virtuelle dédiée.
./code_drop/temp/_PublishedApps/choco
dans votre répertoire d'installation préféré. Sur Linux, le répertoire préféré est /opt/chocolatey
ChocolateyInstall
, pointant vers le répertoire d'installation La sortie de construction a également été copiée../docker/choco_wrapper
dans un répertoire sur le $PATH
, renommer de choco
, et si le répertoire d'installation est autre chose que /opt/chocolatey
, puis modifiez-le pour pointer le bon chemin. Chocolatey vous est apporté par pas mal de personnes et de cadres. Voir les crédits (Just Legal / Credits.md dans le dossier zip).