بسته‌های آفلاین
بسته یک فایل امضاشده است که می‌تواند به‌روزرسانی برنامه، سندهای تازهٔ اشتراک، اعلان یک ارائه‌دهنده، یا ترکیبی از این‌ها را حمل کند. آن را با فلش USB، بلوتوث یا پوشهٔ اشتراکی جابه‌جا کنید. باز کردنش برنامه را به اینترنت وصل نمی‌کند.
بسته چه چیزی حمل می‌کند
Section titled “بسته چه چیزی حمل می‌کند”| بخش | چیست | چه کسی باید امضا کرده باشد |
|---|---|---|
| به‌روزرسانی برنامه | فایلی که به‌روزرسانی آنلاین نصب می‌کند، برای یک سکو | کلید انتشار Veilway |
| بستهٔ سندها (pack) | سندهای اشتراک رمزشده برای دستگاه‌های یک ارائه‌دهنده | کلید امضای ارائه‌دهنده |
| اعلان | پیام کوتاه یک ارائه‌دهنده، تا 8,192 بایت | کلید امضای ارائه‌دهنده |
بسته می‌تواند هر ترکیبی داشته باشد، با حداکثر یک به‌روزرسانی برنامه برای هر سکو و تا 1 GiB. برنامه‌ها اول امضای کل فایل را بررسی می‌کنند و بعد هر بخش را با کلید همان نوع. بسته‌ای که کلیدش را برنامه ندارد رد می‌شود.
ساختن بسته
Section titled “ساختن بسته”یک فایل کلید امضا لازم دارید: 32 بایت تصادفی به شکل base64 که فقط مالکش بتواند بخواند (chmod 600 signing.key).
veilway bundle make --key signing.key --out update.vwbundle \ --app linux-x86_64=./Veilway.AppImage:./Veilway.AppImage.sig| پرچم | معنی |
|---|---|
--key FILE |
فایل کلید امضا. الزامی. حالت 600. |
--out FILE |
بستهٔ خروجی. الزامی. پسوند .vwbundle را بگذارید. |
--app PLATFORM=ARTIFACT:SIGNATURE |
یک به‌روزرسانی برنامه. سکو یکی از linux-x86_64، linux-aarch64، windows-x86_64، macos-aarch64، macos-x86_64 یا android-arm64 است. نسخه و نام فایل از امضا می‌آیند و امضا باید با کلید انتشار درست درآید. برای سکوهای بیشتر تکرار کنید. |
--pack PERIODS=FILE |
یک بستهٔ سندهای رمزشده با دوره‌هایش، مثل 2871,2872=pack.bin. به --bundle-id نیاز دارد. برای بستهٔ بیشتر تکرار کنید. |
--notice FILE |
یک اعلان امضاشده. برای اعلان بیشتر تکرار کنید. |
--bundle-id ID |
شناسهٔ بسته: 32 رقم هگزادسیمال با حروف کوچک. با --pack الزامی است، چون بستهٔ سندها برای یک شناسه رمز می‌شود. بدون آن، شناسه‌ای تصادفی ساخته می‌شود. |
دستور نام فایل، اندازه، تعداد بخش‌ها و اثرانگشت امضاکننده را چاپ می‌کند.
هر بخش را با کلیدی امضا کنید که برنامه‌ها برای آن نوع قبول دارند: کلید انتشار برای به‌روزرسانی برنامه، کلید ارائه‌دهنده برای سندها و اعلان‌ها. برنامه‌ها هر کلید دیگری را رد می‌کنند.
بررسی بسته
Section titled “بررسی بسته”پیش از دادن بسته به کسی inspect را اجرا کنید:
veilway bundle inspect update.vwbundleveilway bundle inspect provider.vwbundle --key <کلید عمومی ارائه‌دهنده، base64>--key کلید عمومی یک ارائه‌دهنده را به کلیدهایی اضافه می‌کند که امضای انتشار با آن‌ها بررسی می‌شود. برای ارائه‌دهندهٔ بیشتر تکرار کنید.
خروجی چهار نوع خط دارد:
- شناسهٔ بسته، زمان ساخت و سن آن:
current،old(بیش از 90 روز) یاdated in the future(بیش از 5 دقیقه جلوتر از ساعت این رایانه). - امضاکننده: یک کلید انتشار Veilway، یا کلید ارائه‌دهنده با اثرانگشتش.
- یک خط برای هر بخش، با علامت
intactیاdamaged, dropped. به‌روزرسانی برنامه‌ای که امضایش درست درنمی‌آید هم dropped علامت می‌خورد. - برای فایل ردشده، فقط یک خط
refused:با دلیل. چیز دیگری چاپ نمی‌شود.
وقتی فایل درست باشد کد خروج 0 است و وقتی رد شود 1. inspect فقط فایل را می‌خواند و از شبکه استفاده نمی‌کند.
آنچه کاربران در برنامه‌ها می‌بینند
Section titled “آنچه کاربران در برنامه‌ها می‌بینند”برنامه‌های دسکتاپ و اندروید یک صفحهٔ بازبینی دارند.
- در صفحه‌ای که اشتراک اضافه می‌کنید، باز کردن بسته را بزنید. انتخابگر دسکتاپ فایل‌های
.vwbundleرا نشان می‌دهد و انتخابگر اندروید همهٔ فایل‌ها را. برنامه‌ها بسته را با ضربه زدن در مدیر فایل باز نمی‌کنند. - برنامه فایل را (تا 1 GiB) در پوشهٔ خودش کپی و بررسی می‌کند. هنوز چیزی اعمال نمی‌شود. فایل ردشده با این پیام می‌آید که با کلید مورداعتماد امضا نشده یا آسیب دیده.
- بررسی این بسته اثرانگشت، امضاکننده و تاریخ ساخت را نشان می‌دهد. می‌گوید «امضاشده با کلید انتشار Veilway» یا «امضاشده با» نام ارائه‌دهنده، با یادآوری اینکه برنامه نمی‌تواند هویت ارائه‌دهنده را بررسی کند. اگر بسته بیش از 90 روز قدیمی باشد یا تاریخش در آینده باشد، پیام هشدار می‌آید.
- هر نوع بخش، بخش خودش را دارد:
- به‌روزرسانی برنامه: اگر به‌روزرسانی جدیدتر و برای این دستگاه باشد، دکمهٔ نصب هست. وگرنه برنامه می‌گوید برای دستگاه دیگری است یا جدیدتر نیست و کنارش می‌گذارد.
- اشتراک‌ها: سند جدیدتر شمارهٔ سریال و تاریخ اعتبارش را نشان می‌دهد. به‌روزرسانی آن را از اتصال بعدی اعمال می‌کند.
- اعلان‌ها: علامت‌زدن به‌عنوان خوانده‌شده اعلان را پنهان می‌کند.
- کنار گذاشته‌شده: هر بخش استفاده‌نشده با دلیلش: بخش آسیب‌دیده، امضای نادرست برنامه، سندی که خوانده نمی‌شود، و اعلان برای اشتراکی که ندارید.
- نصب به‌روزرسانی برنامه می‌پرسد این به‌روزرسانی نصب شود؟ در دسکتاپ اول اتصال در حال اجرا قطع می‌شود و بعد برنامه با نسخهٔ جدید دوباره راه می‌افتد. در اندروید نصب‌کنندهٔ سیستم تأیید شما را می‌خواهد.
- بستن بسته رونوشت برنامه را پاک می‌کند.
تا دکمه‌ای را نزنید چیزی عوض نمی‌شود. بسته‌ای که برای این دستگاه چیزی ندارد همین را می‌گوید.
مطالب مرتبط
Section titled “مطالب مرتبط”- مشخصات بستهٔ آفلاین: ساختار فایل و همهٔ بررسی‌ها.
- قالب اشتراک: سندهایی که بستهٔ سندها حمل می‌کند.