انتشار اپلیکیشن در F-Droid به صورت رایگان

Summarize this content to 400 words in Persian Lang
انتشار برنامه شما در F-Droid شامل چندین مرحله است، از اطمینان از اینکه برنامه شما معیارهای لازم را دارد تا ارسال ابرداده های لازم. در اینجا یک راهنمای دقیق برای کمک به شما در این فرآیند آورده شده است:

1. آماده کردن برنامه شما

مجوز منبع باز

مطمئن شوید که برنامه شما تحت مجوز منبع باز مانند MIT، GPL-3.0-only، یا Apache-2.0 است. F-Droid فقط برنامه های دارای مجوز منبع باز را می پذیرد.

راه اندازی مخزن

کد منبع برنامه شما باید روی یک سیستم کنترل نسخه عمومی مانند GitHub یا GitLab میزبانی شود. مخزن باید عمومی باشد و حاوی تمام فایل های لازم برای ساخت برنامه شما باشد.

2. تنظیم محیط

F-Droid Tools را نصب کنید

شما باید ابزارهای سرور F-Droid را نصب کنید. این کار را می توان بر روی یک ماشین لینوکس با استفاده از دستورات زیر انجام داد:

sudo apt-get install fdroidserver

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

3. ایجاد ابرداده

مخزن داده F-Droid را شبیه سازی کنید

شما باید مخزن داده F-Droid را که حاوی ابرداده برای همه برنامه ها است، کلون کنید.

git clone https://gitlab.com/fdroid/fdroiddata.git
cd fdroiddata

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

یک شعبه جدید ایجاد کنید

یک شعبه جدید به نام نام بسته برنامه خود ایجاد کنید:

git checkout -b com.example.myapp

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

فایل متادیتا ایجاد کنید

یک فایل YAML جدید در metadata دایرکتوری با نام بسته برنامه شما:

nano metadata/com.example.myapp.yml

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

فایل را با جزئیات برنامه خود پر کنید. در اینجا یک مثال است:

Categories:
– Science & Education
– Reading
License: MIT
AuthorName: John Doe
AuthorEmail: john@example.com
AuthorWebSite: https://example.com
SourceCode: https://github.com/username/myapp
IssueTracker: https://github.com/username/myapp/issues
Changelog: https://github.com/username/myapp/releases

AutoName: My App Name
RepoType: git
Repo: https://github.com/username/myapp.git
Binaries: https://github.com/username/myapp/releases/download/v%v/MyApp-%v.apk

Builds:
– versionName: 1.0.1
versionCode: 1
commit: v1.0.1
subdir: app
sudo:
– apt-get update
– apt-get install -y openjdk-17-jdk-headless
– update-java-alternatives -a
gradle:
– yes

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

4. تأیید و ساخت

فراداده را بخوانید

مطمئن شوید که فایل ابرداده شما بدون خطا است:

fdroid readmeta

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

بازنویسی متادیتا

فایل ابرداده را پاک و بازنویسی کنید:

fdroid rewritemeta com.example.myapp

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

متادیتا لینت

برای هر گونه هشدار در فراداده بررسی کنید:

fdroid lint com.example.myapp

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

برنامه را بسازید

برنامه خود را با استفاده از ابزارهای F-Droid بسازید:

fdroid build -v -l com.example.myapp

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

5. ارسال برنامه شما

به GitLab فشار دهید

تغییرات خود را انجام دهید و آنها را به فورک مخزن داده F-Droid در GitLab فشار دهید:

git add .
git commit -m “Added My App”
git remote set-url origin https://gitlab.com/YOUR-USERNAME/fdroiddata.git
git push -u origin com.example.myapp

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

6. ایجاد یک درخواست ادغام

به مخزن GitLab خود بروید و یک درخواست ادغام به مخزن اصلی داده F-Droid ایجاد کنید. نگهبانان F-Droid درخواست شما را بررسی می کنند و اگر همه چیز درست باشد، برنامه شما را در مخزن اصلی ادغام می کنند.

7. جزئیات اضافی

دارایی های گرافیکی

برای اضافه کردن نمادها و اسکرین شات ها، آنها را با استفاده از ساختار پوشه Fastlane یا Triple-T در مخزن برنامه خود اضافه کنید. این به F-Droid کمک می کند تا این دارایی ها را در فروشگاه برنامه واکشی و نمایش دهد.

خطوط لوله CI/CD

خطوط لوله CI/CD را در GitLab نظارت کنید تا مطمئن شوید که خطای ساخت وجود ندارد. اگر خطوط لوله با موفقیت انجام شود، برنامه شما به زودی در F-Droid در دسترس خواهد بود.

یادداشت های پایانی

انتشار در F-Droid ممکن است یک یا دو روز پس از ادغام طول بکشد. می توانید برنامه خود را با استفاده از گرافیک رسمی F-Droid که در وب سایت آنها یافت می شود تبلیغ کنید.

برای دستورالعمل ها و مثال های دقیق تر، به اسناد رسمی F-Droid، راهنمای انجمن توسعه دهندگان و وبلاگ Random Bits مراجعه کنید.

این فرآیند جامع تضمین می کند که برنامه شما با استانداردهای F-Droid مطابقت دارد و منبع قابل اعتمادی را برای برنامه های Android منبع باز در اختیار کاربران قرار می دهد.

sudo apt-get install fdroidserver

git clone https://gitlab.com/fdroid/fdroiddata.git
cd fdroiddata

git checkout -b com.example.myapp

nano metadata/com.example.myapp.yml

Categories:
  - Science & Education
  - Reading
License: MIT
AuthorName: John Doe
AuthorEmail: john@example.com
AuthorWebSite: https://example.com
SourceCode: https://github.com/username/myapp
IssueTracker: https://github.com/username/myapp/issues
Changelog: https://github.com/username/myapp/releases

AutoName: My App Name
RepoType: git
Repo: https://github.com/username/myapp.git
Binaries: https://github.com/username/myapp/releases/download/v%v/MyApp-%v.apk

Builds:
  - versionName: 1.0.1
    versionCode: 1
    commit: v1.0.1
    subdir: app
    sudo:
      - apt-get update
      - apt-get install -y openjdk-17-jdk-headless
      - update-java-alternatives -a
    gradle:
      - yes

fdroid readmeta

fdroid rewritemeta com.example.myapp

fdroid lint com.example.myapp

fdroid build -v -l com.example.myapp

git add .
git commit -m "Added My App"
git remote set-url origin https://gitlab.com/YOUR-USERNAME/fdroiddata.git
git push -u origin com.example.myapp