Skip to content

Commit

Permalink
docs: add Download section to README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
jeszy75 committed Apr 27, 2024
1 parent 0d48ceb commit 0ed6830
Show file tree
Hide file tree
Showing 2 changed files with 51 additions and 0 deletions.
47 changes: 47 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,50 @@ If your project is about a two-player game, the class implementing the state-spa
## Documentation

* [Javadoc](https://inbpm0420l.github.io/homework-project-utils/javadoc/)

## Download

Add the following dependency to your `pom.xml` file:

```xml
<dependency>
<groupId>hu.unideb.inf</groupId>
<artifactId>homework-project-utils</artifactId>
<version>1.0.0</version>
<scope>compile</scope>
</dependency>
```

The artifact can be downloaded from [GitHub Packages](https://docs.github.com/en/packages) that requires the following element to be added to your `pom.xml` file:

```xml
<repositories>
<repository>
<id>github</id>
<url>https://maven.pkg.github.com/INBPM0420L/homework-project-utils</url>
</repository>
</repositories>
```

Note that GitHub Packages requires authentication using a personal access token (classic) that can be created [here](https://github.com/settings/tokens).

> [!IMPORTANT]
> You must create a personal access token (PAT) with the `read:packages` scope.
Finally, you need a `settings.xml` file with the following content to store your PAT:

```xml
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
<servers>
<server>
<id>github</id>
<username><!-- Your GitHub username --></username>
<password><!-- Your GitHub personal access token (classic) --></password>
</server>
</servers>
</settings>
```

The `settings.xml` file must be placed in the `.m2` directory in your home directory, i.e., in the same directory that stores your local Maven repository.
4 changes: 4 additions & 0 deletions src/main/java/game/State.java
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
package game;

public class State {
}

0 comments on commit 0ed6830

Please sign in to comment.