文件列表:

.idea/ (0, 2023-12-17)
.idea/codeStyles/ (0, 2023-12-17)
.idea/codeStyles/Project.xml (490, 2023-12-17)
.idea/codeStyles/codeStyleConfig.xml (142, 2023-12-17)
CODE_OF_CONDUCT.md (3383, 2023-12-17)
LICENSE (1096, 2023-12-17)
build.gradle.kts (2082, 2023-12-17)
gradle.properties (1822, 2023-12-17)
gradle/ (0, 2023-12-17)
gradle/wrapper/ (0, 2023-12-17)
gradle/wrapper/gradle-wrapper.jar (63375, 2023-12-17)
gradle/wrapper/gradle-wrapper.properties (250, 2023-12-17)
gradlew (8527, 2023-12-17)
gradlew.bat (2776, 2023-12-17)
settings.gradle.kts (307, 2023-12-17)
src/ (0, 2023-12-17)
src/main/ (0, 2023-12-17)
src/main/java/ (0, 2023-12-17)
src/main/java/de/ (0, 2023-12-17)
src/main/java/de/tum/ (0, 2023-12-17)
src/main/java/de/tum/www1/ (0, 2023-12-17)
... ...

# Orion IntelliJ Plugin Open Artemis IDE plugin for the programming exercise integration. This plugin integrates the [Artemis](https://github.com/ls1intum/Artemis) interactive learning platform into the IntelliJ IDE. It allows you to directly import programming exercises from Artemis and submit your changes to the build servers. Detailed documentation is integrated into [Artemis' documentation](https://artemis-platform.readthedocs.io/en/latest/user/orion/). **Current Version:**  ## Example Usage  ## Manual Installation Download the release from [here](https://github.com/ls1intum/Orion/releases) and install it as described [further down in this document](https://github.com/ls1intum/Orion#install-release-zip). ## Planned Features We want to integrate the following features into the plugin: - Integration of the [JetBrains Edu Tools](https://plugins.jetbrains.com/plugin/10081-edutools) - Support for team exercises - Automatic conflict resolution ## Development ### Run/Debug the Plugin - Import as gradle project - Select the JBR `>17` as the project SDK with language level 17 - Run Gradle task: `runIde`. This will open a new IntelliJ window with the plugin installed. ### Perform Version Upgrade Upon release of a new mayor IntelliJ version, the plugin needs to be upgraded to support the new version. This upgrade can oftentimes also be performed without much knowledge of the codebase. In the following, the necessary steps are outlined: 1. If you do not have write access to the GitHub repository, fork the repository and clone it 2. Make sure you are able to run the plugin locally as described above 3. Adapt the versions in the build configuration file [build.gradle.kts](https://github.com/ls1intum/Orion/blob/main/build.gradle.kts) 1. At `intellij`, change the version property to the latest version. This is the IntelliJ version used for "runIde". Also adapt the version numbers of all versioned plugins at `intellij`→`plugins`. You can look up each plugin in the IntelliJ marketplace and find the latest compatible version there. 2. At `tasks`→`patchPluginXml`, change the `sinceBuild` and `untilBuild` property accordingly, the format is explained in a comment there. 3. Optionally upgrade the versions of the dependencies at `plugins` and `dependencies`, however this is usually not necessary. 4. Run the project locally with runIde or buildPlugin. If compilation errors happen, try to resolve them; on version changes, IntelliJ sometimes deprecates APIs or moves packages. Fixing these errors requires looking into and changing the code. A very helpful resource is the [documentation of the IntelliJ Platform SDK](https://plugins.jetbrains.com/docs/intellij/welcome.html). 5. When the plugin runs locally, create a pull request with your changes. Also consider notifying a maintainer of Orion or Artemis to make sure your pull request gets noticed. ### Testing of Pull Requests 1. #### Download Release (.zip) Download the release file from the pull request's _Checks_ → _Artifacts_ → _orion_ The artifact is unavailable during building. The full history of artifacts can be retrieved though the _Actions_ tab  2. #### Install Release (.zip) Install the release file in IntelliJ at _Settings_ → _Plugins_ → _Settings_ → _Install Plugin from Disk..._ → Select the file 

Installation process as gif


## Publish a new Release **Before you release any new version, make sure that all version properties in the repository are updated (`version` in `build.gradle.kts`) and the changelog contains the relevant version information (also in `build.gradle.kts`)** Follow the steps outlined here:  1. Go to the GitHub "_Actions_" tab on the Orion repository 2. Select the "_Release_" workflow 3. Click on "_Run workflow_" and input the new version number to release (e.g. `1.5.0` releases and tags version `v1.5.0`) 4. An admin now has to review and accept the new release by viewing the created workflow run  5. After the release is approved, GitHub will automatically build and upload the artifact. It will also create a new draft GitHub release 6. An admin needs to promote the GitHub draft release in order to properly tag and release the latest build on GitHub. 1. Go to the releases page and open the generated latest draft release of Orion 2. Update the changelog by copy-pasting the information into the description box 3. Click on 'Publish release' to finish the process  The latest plugin artifact is now available on both GitHub and via the JetBrains marketplace. **It might take some time for the latest version to be seen on the marketplace since JetBrains still has to review and approve the changes!** ### Release Process Implementation **How can I modify the pipeline?** The release pipeline is fully implemented using GitHub actions. In order to change anything about the process you just have to edit the `release.yml` in the `.github/workflows` directory. **Where can I find secrets like the authentication token for the JetBrains repository?** Admins of the GitHub repository can modify the build environment under _Settings -> Environments -> prod_. This includes adding and updating any secrets that should get injected into the environment during the build process. ## Feedback? Questions? Email: krusche(at)tum(dot)de

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：