You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

nightlies.md 3.1 kB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485
  1. ---
  2. uid: Guides.GettingStarted.Installation.Nightlies
  3. title: Installing Nightly Build
  4. ---
  5. # Installing Discord.Net Nightly Build
  6. Before Discord.Net pushes a new set of features into the stable
  7. version, we use nightly builds to test the features with the
  8. community for an extensive period of time. Each nightly build is
  9. compiled by AppVeyor whenever a new commit is made and will be pushed
  10. to our MyGet feed.
  11. > [!IMPORTANT]
  12. > Before beginning, it is important to note that although nightlies
  13. > are generally stable and have more features and bug fixes than
  14. > the current stable build on NuGet, there **will** be breaking
  15. > changes during the development or breaking bugs. Although breaking
  16. > bugs are usually fixed as soon as they are discovered, it is still
  17. > important to keep this in mind.
  18. ## Installing with MyGet (Recommended)
  19. MyGet is typically used by many development teams to publish their
  20. latest pre-release packages before the features are finalized and
  21. pushed to NuGet.
  22. The following is the feed link of Discord.Net,
  23. * `https://www.myget.org/F/discord-net/api/v3/index.json`
  24. Depending on which IDE you use, there are many different ways of
  25. adding the feed to your package source.
  26. ### [Visual Studio](#tab/vs)
  27. 1. Go to `Tools` > `NuGet Package Manager` > `Package Manager Settings`
  28. ![VS](images/nightlies-vs-step1.png)
  29. 2. Go to `Package Sources`
  30. ![Package Sources](images/nightlies-vs-step2.png)
  31. 3. Click on the add icon
  32. 4. Fill in the desired name and source as shown below and hit `Update`
  33. ![Add Source](images/nightlies-vs-step4.png)
  34. > [!NOTE]
  35. > Remember to tick the `Include prerelease` checkbox to see the
  36. > nightly builds!
  37. > ![Checkbox](images/nightlies-vs-note.png)
  38. ### [Local NuGet.Config](#tab/local-nuget-config)
  39. If you plan on deploying your bot or developing outside of Visual
  40. Studio, you will need to create a local NuGet configuration file for
  41. your project.
  42. To do this, create a file named `NuGet.Config` alongside the root of
  43. your application, where the project is located.
  44. Paste the following snippets into this configuration file, adding any
  45. additional feeds if necessary.
  46. [!code[NuGet Configuration](samples/nuget.config)]
  47. After which, you may install the packages by directly modifying the
  48. project file, using the dotnet CLI (`dotnet add package Discord.Net`),
  49. or by using PowerShell (`Install-Package Discord.Net -Prerelease`).
  50. ***
  51. ## Installing from AppVeyor Artifacts
  52. As mentioned in the first paragraph, we utilize AppVeyor to perform
  53. automated test and build publishing. During the publishing process,
  54. we also upload the NuGet packages onto AppVeyor's Artifact collection.
  55. The latest build status can be found within our [AppVeyor project].
  56. [AppVeyor project]: https://ci.appveyor.com/project/rogueexception/discord-net
  57. 1. In the project, you may find our latest build including the
  58. aforementioned artifacts.
  59. ![Artifacts](images/appveyor-artifacts.png)
  60. 2. In the artifacts collection, you should see the latest packages
  61. packed in `*.nupkg` form which you could download from and use.
  62. ![NuPkgs](images/appveyor-nupkg.png)