JeKa: Maven Central에 게시하는 가장 간단한 방법

JeKa는 단순성에 초점을 맞춘 최신 Java 빌드 도구입니다.
이 게시물은 최소한의 구성으로 Maven Central에 게시하는 방법을 보여줍니다.

전제 조건: Maven Central에 게시하려면 OSSRH 계정이 필요합니다.

JeKa를 사용하면 다음과 같이 jeka.properties 파일을 편집하여 빌드를 완전히 구성할 수 있습니다.

jeka.version=0.11.11
jeka.java.version=17

jeka.inject.classpath=dev.jeka:nexus-plugin
@nexus=

@project.moduleId=com.github.djeang:vincer-dom
@project.gitVersioning.enable=true

# Configuration for deploying to Maven central
@maven.publication.predefinedRepo=OSSRH
@maven.publication.metadata.projectName=Vincer-Dom
@maven.publication.metadata.projectDescription=Modern Dom manipulation library for Java
@maven.publication.metadata.projectUrl=https://github.com/djeang/vincer-dom
@maven.publication.metadata.projectScmUrl=https://github.com/djeang/vincer-dom.git
@maven.publication.metadata.licenses=Apache License V2.0:https://www.apache.org/licenses/LICENSE-2.0.html
@maven.publication.metadata.developers=djeang:djeangdev@yahoo.fr

종속성은 문제를 명확하게 구분하기 위해 전용 dependent.txt 파일에 나열됩니다.

Maven Central에 게시하려면 jeka project:pack maven:publish를 실행하세요.

여기에서 구체적인 예를 확인하세요.

설명

이제 어떻게 하는지 알았으니, 어떻게 작동하는지 설명해 보겠습니다.

Jeka 및 Java 버전 관리

더 나은 이식성과 재현성을 위해 빌드에 필요한 Jeka 버전과 Java 버전을 모두 선언할 수 있습니다. 호스트 컴퓨터에 아직 없는 경우 두 버전 모두 자동으로 다운로드됩니다.

모듈 ID 및 버전 지정 지정

게시된 모듈 ID는 @project.moduleId 속성을 사용하여 지정됩니다.

버전은 @project.version 속성을 사용하여 명시적으로 지정할 수 있습니다. 속성은 jeka.properties 파일에서 설정하거나 명령줄 인수로 전달할 수 있습니다: -D@project.version=1.0.1.

대신, @project.gitVersioning.enable=true를 사용하여 버전을 추론하기 위해 Git에 의존하기로 선택했습니다. 현재 커밋에 태그가 없으면 버전은 [branch]-SNAPSHOT으로 설정됩니다. 그렇지 않으면 태그 이름이 됩니다.

출판 저장소 구성

@maven.publication.pre DefinedRepo=OSSRH는 Jeka에게 미리 정의된 OSSRH 저장소에 게시하도록 지시합니다. 이 저장소는 버전이 -SNAPSHOT으로 끝나면 OSSRH 스냅샷 저장소에 게시하고, 그렇지 않으면 릴리스 저장소에 게시하도록 구성됩니다.

저장소는 다음 환경 변수를 사용하여 비밀을 전달합니다.

• jeka.repos.publish.username: OSSRH 계정 사용자 이름
• jeka.repos.publish.password: OSSRH 계정 비밀번호
• jeka.gpg.secret-key: 문자열로 된 Armored GPG 비밀 키
• jeka.gpg.passphrase: 비밀키를 보호하는 암호

jeka.gpg.secret-key의 내용은 gpg --export-secret-key --armor my-key-name을 실행하여 얻을 수 있습니다.

출판물 메타데이터 제공

필수 메타데이터는 @maven.publication.metadata.xxx 속성을 사용하여 설정됩니다.

@maven.publication.metadata.licenses 속성에는 [license1 name]:[license1 url],[license2 name]:[license2 url],...

과 같은 형식이 필요합니다.

릴리스 출판 자동화

편의를 위해 Nexus 플러그인을 사용합니다.

수동 개입 없이 자동으로 스테이징 저장소를 닫습니다.

jeka.inject.classpath=dev.jeka:nexus-plugin은 Jeka에게 Maven Central에서 플러그인을 가져오도록 지시하고 @nexus=는 플러그인을 활성화합니다.

빌드 실행

게시하려면 jeka project:pack maven:publish를 실행하면 됩니다.

이렇게 됩니다.

• 게시할 JAR을 생성합니다(프로젝트: pack).
• 소스 및 Javadoc JAR을 생성합니다.
• 게시된 POM 파일을 생성합니다.
• 모든 체크섬을 계산합니다.
• 게시된 모든 파일에 서명하세요.
• 모든 것을 OSSRH 저장소로 푸시하세요.

게시될 내용을 보려면 jeka maven: info를 실행하세요.

미세 조정

Jeka의 미세 조정은 일반적으로 jeka.properties 파일의 선언적 구성을 보완하여 프로그래밍 방식으로 수행됩니다. 이 접근 방식을 사용하면 정적 유형 지정의 이점과 함께 매우 유연하고 강력한 구성이 가능합니다.

전이적 종속성 사용자 정의

게시된 POM에 언급된 종속성을 사용자 정의할 수 있습니다.

다음 예에서는 com.google.guava:guava 종속성을 제거하고 jfiglet 종속성이 RUNTIME 범위를 갖도록 강제합니다.

jeka.version=0.11.11
jeka.java.version=17

jeka.inject.classpath=dev.jeka:nexus-plugin
@nexus=

@project.moduleId=com.github.djeang:vincer-dom
@project.gitVersioning.enable=true

# Configuration for deploying to Maven central
@maven.publication.predefinedRepo=OSSRH
@maven.publication.metadata.projectName=Vincer-Dom
@maven.publication.metadata.projectDescription=Modern Dom manipulation library for Java
@maven.publication.metadata.projectUrl=https://github.com/djeang/vincer-dom
@maven.publication.metadata.projectScmUrl=https://github.com/djeang/vincer-dom.git
@maven.publication.metadata.licenses=Apache License V2.0:https://www.apache.org/licenses/LICENSE-2.0.html
@maven.publication.metadata.developers=djeang:djeangdev@yahoo.fr

추가 아티팩트 추가

API를 사용하면 게시할 추가 아티팩트를 정의할 수 있습니다.

다음 예에서는 게시 시 두 개의 아티팩트가 생성됩니다.

1. 문서가 포함된 ZIP 파일.
2. 음영 처리된 uber JAR(충돌을 피하기 위해 이름이 변경된 패키지와 함께 종속성의 모든 클래스를 포함하는 JAR)

class Build extends KBean {

    @Override
    void init() {
        var publication = load(MavenKBean.class).getMavenPublication();
        publication.customizeDependencies(deps -> deps
                .minus("com.google.guava:guava")
                .withTransitivity("com.github.lalyos:jfiglet", JkTransitivity.RUNTIME)
        );
    }

}

다른 저장소에 게시

Maven Central 이외의 저장소에 게시하려면 다음 속성을 설정할 수 있습니다.

class Build extends KBean {

    @Override
    void init() {
        var publication = load(MavenKBean.class).getMavenPublication();
        publication.putArtifact(JkArtifactId.of("doc", "zip"), this::genDoc);
        publication.putArtifact(JkArtifactId.of("shade", "jar"), project.packaging::createShadeJar);
    }

    private void genDoc(Path targetZipFile) {
        // generate documentation and zip it in targetZipFile
    }

}

이러한 속성을 [USER HOME]/.jeka/global.properties(jeka.properties 파일 대신)에 배치하여 프로젝트 전체에서 구성을 일관되게 유지하고 중복을 방지하세요.

자세한 내용은 설명서를 참조하세요.

메이븐과의 비교

다음은 Maven Central에 프로젝트를 배포하는 것과 동일한 Maven POM 구성입니다.

jeka.repos.publish=https://my.company/myrepo

# Optional properties
jeka.repos.publish.username=myUsername
jeka.repos.publish.password=myPassword
jeka.repos.publish.headers.Authorization=Bearer:: XHrU8hHKJHJ454==67g

결론

Jeka는 기존 도구보다 훨씬 적은 구성과 노력으로 Java 소프트웨어를 구축하고 Maven Central 또는 기타 저장소에 아티팩트를 게시할 수 있는 간단하면서도 강력한 방법을 제공합니다.

Jeka가 더 잘할 수 있는 모든 것에 대한 아이디어를 얻으려면 웹사이트, 동영상, 예시를 방문하세요.

면책조항: 저는 Jeka의 저자입니다.

위 내용은 JeKa: Maven Central에 게시하는 가장 간단한 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!