انتقل إلى المحتوى

Maven

لنشر package بلغة Java بصيغة Maven على ليڤانت غيت (LevantGit)، أضف الـ access token إلى ملف settings.xml، وعرّف الـ repository في pom.xml بعنوان حسابك على الـ registry، ثم نفّذ mvn deploy. تشرح هذه الصفحة الضبط بـ Maven وبـ Gradle معًا، وطريقة استخدام الحزمة بعد نشرها.

ملاحظة

الـ package registry متاح إن كان مفعّلاً على levantgit.com؛ تظهر تبويبة Packages في ملفك الشخصي أو في الـ repository عندها.

ما تحتاج إليه

  • Maven أو Gradle. الأمثلة أدناه بـ Maven وبـ Gradle Groovy.
  • access token من إعدادات الحساب: Settings ← Applications، بصلاحية package.

ضبط الـ registry

Maven

أضف الـ access token أولًا إلى ملف settings.xml (عادةً في ~/.m2/settings.xml):

<settings>
  <servers>
    <server>
      <id>LevantGit</id>
      <configuration>
        <httpHeaders>
          <property>
            <name>Authorization</name>
            <value>token {access_token}</value>
          </property>
        </httpHeaders>
      </configuration>
    </server>
  </servers>
</settings>

ثم أضف إلى ملف pom.xml في مشروعك:

<repositories>
  <repository>
    <id>LevantGit</id>
    <url>https://levantgit.com/api/packages/{owner}/maven</url>
  </repository>
</repositories>
<distributionManagement>
  <repository>
    <id>LevantGit</id>
    <url>https://levantgit.com/api/packages/{owner}/maven</url>
  </repository>
  <snapshotRepository>
    <id>LevantGit</id>
    <url>https://levantgit.com/api/packages/{owner}/maven</url>
  </snapshotRepository>
</distributionManagement>
المعامل الوصف
access_token الـ access token الذي أنشأته.
owner الـ owner: اسم المستخدم أو الـ organization.

لاحظ أن <id> في pom.xml يجب أن يطابق <id> في settings.xml حتى يُرسل الـ token.

Gradle

لاستخدام packages من ليڤانت غيت في مشروعك، أضف الـ registry في قسم repositories:

repositories {
    // other repositories
    maven { url "https://levantgit.com/api/packages/{owner}/maven" }
}

وللنشر أضف إلى قسم publishing:

publishing {
    // other settings of publication
    repositories {
        maven {
            name = "LevantGit"
            url = uri("https://levantgit.com/api/packages/{owner}/maven")

            credentials(HttpHeaderCredentials) {
                name = "Authorization"
                value = "token {access_token}"
            }

            authentication {
                header(HttpHeaderAuthentication)
            }
        }
    }
}

نشر package

بـ Maven:

mvn deploy

أو بـ Gradle عبر المهمة publishAllPublicationsToLevantGitRepository:

./gradlew publishAllPublicationsToLevantGitRepository

ولنشر ملف جاهز (jar مبني مسبقًا) استخدم mvn deploy:deploy-file:

mvn deploy:deploy-file -Durl=https://levantgit.com/api/packages/{owner}/maven -DrepositoryId=LevantGit -Dfile=/path/to/package.jar
المعامل الوصف
owner الـ owner.

لا يمكن نشر package إن كانت أخرى بالاسم نفسه والإصدار نفسه موجودة؛ احذف القديمة أولًا من تبويبة Packages، أو ارفع رقم الإصدار.

تثبيت package

أضف التبعية إلى pom.xml:

<dependency>
  <groupId>com.test.package</groupId>
  <artifactId>test_project</artifactId>
  <version>1.0.0</version>
</dependency>

وما يقابلها في Gradle Groovy:

implementation "com.test.package:test_project:1.0.0"

ثم نفّذ:

mvn install

الأوامر المدعومة

mvn install
mvn deploy
mvn dependency:get:

ماذا بعد؟

هذه الصفحة مبنية على وثائق Gitea (رخصة MIT) بعد ترجمتها وتبسيطها.