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.

الإدخالات

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 أو أحدث
فئة المهمة	البنية