AndroidSigning@3 - مهمة توقيع Android v3
استخدم هذه المهمة في البنية الأساسية لبرنامج ربط العمليات التجارية لتوقيع ملفات Android APK ومحاذاتها.
بناء الجملة
# Android Signing v3
# Sign and align Android APK files.
- task: AndroidSigning@3
inputs:
apkFiles: '**/*.apk' # string. Alias: files. Required. APK files. Default: **/*.apk.
# Signing Options
#apksign: true # boolean. Sign the APK. Default: true.
apksignerKeystoreFile: # string. Alias: keystoreFile. Required when apksign = true. Keystore file.
#apksignerKeystorePassword: # string. Alias: keystorePass. Optional. Use when apksign = true. Keystore password.
#apksignerKeystoreAlias: # string. Alias: keystoreAlias. Optional. Use when apksign = true. Alias.
#apksignerKeyPassword: # string. Alias: keyPass. Optional. Use when apksign = true. Key password.
#apksignerVersion: 'latest' # string. Optional. Use when apksign = true. apksigner version. Default: latest.
#apksignerArguments: '--verbose' # string. Optional. Use when apksign = true. apksigner arguments. Default: --verbose.
#apksignerFile: # string. Alias: apksignerLocation. Optional. Use when apksign = true. apksigner location.
# Zipalign Options
#zipalign: true # boolean. Zipalign. Default: true.
#zipalignVersion: 'latest' # string. Optional. Use when zipalign = true. Zipalign version. Default: latest.
#zipalignFile: # string. Alias: zipalignLocation. Optional. Use when zipalign = true. Zipalign location.
# Android Signing v3
# Sign and align Android APK files.
- task: AndroidSigning@3
inputs:
apkFiles: '**/*.apk' # string. Alias: files. Required. APK files. Default: **/*.apk.
# Signing Options
#apksign: true # boolean. Sign the APK. Default: true.
apksignerKeystoreFile: # string. Alias: keystoreFile. Required when apksign = true. Keystore file.
#apksignerKeystorePassword: # string. Alias: keystorePass. Optional. Use when apksign = true. Keystore password.
#apksignerKeystoreAlias: # string. Alias: keystoreAlias. Optional. Use when apksign = true. Alias.
#apksignerKeyPassword: # string. Alias: keyPass. Optional. Use when apksign = true. Key password.
#apksignerArguments: '--verbose' # string. Optional. Use when apksign = true. apksigner arguments. Default: --verbose.
#apksignerFile: # string. Alias: apksignerLocation. Optional. Use when apksign = true. apksigner location.
# Zipalign Options
#zipalign: true # boolean. Zipalign. Default: true.
#zipalignFile: # string. Alias: zipalignLocation. Optional. Use when zipalign = true. Zipalign location.
الإدخالات
apkFiles
- ملفات APK
الاسم المستعار للإدخل: files
. string
. مطلوب القيمة الافتراضية: **/*.apk
.
المسار النسبي من جذر المستودع إلى APK (واجهات) برمجة التطبيقات التي تريد توقيعها. يمكنك استخدام أحرف البدل لتحديد ملفات متعددة. على سبيل المثال:
outputs\apk*.apk
لتوقيع الكل . ملفات APK فيoutputs\apk\
المجلد الفرعي.**/bin/*.apk
لتوقيع الكل . ملفات APK في جميعbin
المجلدات الفرعية.
apksign
- توقيع APK
boolean
. القيمة الافتراضية: true
.
توقيع APK مع ملف Android Keystore المتوفر. يمكن تشغيل APKs غير الموقعة فقط في المحاكي. يجب توقيع APKs للتشغيل على جهاز.
apksignerKeystoreFile
- ملف مخزن المفاتيح
الاسم المستعار للإدخل: keystoreFile
. string
. مطلوب عند apksign = true
.
مسار الملف إلى ملف Android Keystore المستخدم لتوقيع APK. يجب تحميل هذا الملف إلى مكتبة الملفات الآمنة ، حيث يتم تخزينه بأمان مع التشفير. تتم إزالة ملف Android Keystore من جهاز العامل عند اكتمال البنية الأساسية لبرنامج ربط العمليات التجارية.
يمكن إيداع الملف إما في التحكم بالمصادر أو وضعه على جهاز الإنشاء مباشرة من قبل مسؤول. يوصى بتشفير ملف مخزن المفاتيح في التحكم بالمصادر واستخدام Decrypt File
المهمة لفك تشفير الملف أثناء الإنشاء.
apksignerKeystorePassword
- كلمة مرور مخزن المفاتيح
الاسم المستعار للإدخل: keystorePass
. string
. اختياري. استخدم عندما apksign = true
.
كلمة المرور الرئيسية لملف Android Keystore المتوفر.
هام
استخدم متغيرا جديدا مع تمكين تأمينه في جزء المتغيرات لتشفير هذه القيمة. راجع المتغيرات السرية.
apksignerKeystoreAlias
- الاسم المستعار
الاسم المستعار للإدخل: keystoreAlias
. string
. اختياري. استخدم عندما apksign = true
.
الاسم المستعار الذي يعرف زوج المفاتيح العامة/الخاصة لاستخدامه في ملف Android Keystore.
apksignerKeyPassword
- كلمة المرور الرئيسية
الاسم المستعار للإدخل: keyPass
. string
. اختياري. استخدم عندما apksign = true
.
كلمة المرور الرئيسية للاسم المستعار وملف مخزن المفاتيح.
هام
استخدم متغيرا جديدا مع تمكين تأمينه في جزء المتغيرات لتشفير هذه القيمة. راجع المتغيرات السرية.
apksignerVersion
- إصدار apksigner
string
. اختياري. استخدم عندما apksign = true
. القيمة الافتراضية: latest
.
إصدار أدوات إنشاء Android SDK الذي apksigner
يستخدمه الملف التنفيذي للمهمة.
apksignerArguments
- وسيطات apksigner
string
. اختياري. استخدم عندما apksign = true
. القيمة الافتراضية: --verbose
.
يوفر خيارات لتمريرها إلى apksigner
سطر الأوامر. راجع وثائق apksigner.
apksignerFile
- موقع apksigner
الاسم المستعار للإدخل: apksignerLocation
. string
. اختياري. استخدم عندما apksign = true
.
تحديد موقع apksigner القابل للتنفيذ المستخدم أثناء التوقيع. يتم تعيين هذا افتراضيا إلى apksigner الموجود في مجلد إصدار Android SDK الذي ينشئ التطبيق الخاص بك مقابله.
zipalign
- Zipalign
boolean
. القيمة الافتراضية: true
.
حدد ما إذا كنت تريد ضغط الحزمة الخاصة بك. وهذا يقلل من كمية ذاكرة الوصول العشوائي التي يستهلكها أحد التطبيقات.
zipalignVersion
- إصدار Zipalign
string
. اختياري. استخدم عندما zipalign = true
. القيمة الافتراضية: latest
.
إصدار أدوات إنشاء Android SDK الذي zipalign
يستخدمه الملف التنفيذي للمهمة.
zipalignFile
- موقع Zipalign
الاسم المستعار للإدخل: zipalignLocation
. string
. اختياري. استخدم عندما zipalign = true
.
تحديد موقع zipalign
الملف القابل للتنفيذ المستخدم أثناء التوقيع. هذا افتراضيا إلى zipalign
الموجود في مجلد إصدار Android SDK الذي ينشئ التطبيق الخاص بك مقابله.
خيارات التحكم بالمهمة
تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.
متغيرات الإخراج
لا شيء
الملاحظات
استخدم هذه المهمة في البنية الأساسية لبرنامج ربط العمليات التجارية لتوقيع ملفات Android APK ومحاذاتها.
يستخدم هذا الإصدار من المهمة apksigner بدلا من jarsigner لتوقيع APKs.
المتطلبات
المتطلب | الوصف |
---|---|
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية | YAML، الإصدار الكلاسيكي |
يعمل على | Agent, DeploymentGroup |
المطالب | يجب أن يكون لدى الوكلاء المستضافين ذاتيا قدرات تتطابق مع المطالب التالية لتشغيل المهام التي تستخدم هذه المهمة: JDK |
القدرات | لا تفي هذه المهمة بأي طلبات للمهام اللاحقة في الوظيفة. |
قيود الأوامر | يتم تشغيل هذه المهمة باستخدام قيود الأمر التالية: مقيد |
متغيرات Settable | هذه المهمة لديها إذن لتعيين المتغيرات التالية: تم تعطيل تعيين المتغيرات |
إصدار الوكيل | 2.182.1 أو أحدث |
فئة المهمة | البنية |
المتطلب | الوصف |
---|---|
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية | YAML، الإصدار الكلاسيكي |
يعمل على | Agent, DeploymentGroup |
المطالب | يجب أن يكون لدى العوامل المستضافة ذاتيا قدرات تطابق المطالب التالية لتشغيل المهام التي تستخدم هذه المهمة: JDK |
القدرات | لا تفي هذه المهمة بأي طلبات للمهام اللاحقة في الوظيفة. |
قيود الأوامر | أي |
متغيرات Settable | أي |
إصدار الوكيل | 2.116.0 أو أحدث |
فئة المهمة | البنية |
المتطلب | الوصف |
---|---|
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية | YAML، الإصدار الكلاسيكي |
يعمل على | Agent, DeploymentGroup |
المطالب | يجب أن يكون لدى العوامل المستضافة ذاتيا قدرات تطابق المطالب التالية لتشغيل المهام التي تستخدم هذه المهمة: JDK وAndroidSDK |
القدرات | لا تفي هذه المهمة بأي طلبات للمهام اللاحقة في الوظيفة. |
قيود الأوامر | أي |
متغيرات Settable | أي |
إصدار الوكيل | 2.116.0 أو أحدث |
فئة المهمة | البنية |
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ