إصدارات قديمة

2.3 (آذار/مارس 2017)

يهدف الإصدار 2.3.0 من "استوديو Android" في المقام الأول إلى إصلاح الأخطاء وتعزيز الثبات، ولكنه يتضمّن أيضًا عددًا من الميزات الجديدة.

<h3 class="hide-from-toc">
  New
</h3>

<div class="video-wrapper-left">
  <iframe class="devsite-embedded-youtube-video" data-video-id="VFyKclKBGf0"
          data-autohide="1" data-showinfo="0" frameborder="0" allowfullscreen>
  </iframe>
</div>

<ul>
  <li>Android Studio can now convert PNG, BMP, JPG, and static GIF files to
  WebP format. WebP is an image file format from Google that provides lossy
  compression (like JPEG) as well as transparency (like PNG) but can provide
  better compression than either JPEG or PNG. For more information, see
    <a href="/studio/write/convert-webp.html">Convert images to WebP in Android
    Studio</a>.
  </li>

  <li>The new <a href="/studio/write/app-link-indexing.html">App Links
  Assistant</a> simplifies the process of adding Android App Links to your app
  into a step-by-step wizard. Android App Links are HTTP URLs that bring users
  directly to specific content in your Android app.
  </li>

  <li>The Layout Editor now includes support for two new ConstraintLayout
  features:
    <ul>
      <li>Define a view size based on an aspect ratio.
      </li>
      <li>Create packed, spread, and weighted linear groups with constraint
      chains.
      </li>
    </ul>
    For more information, see <a href=
    "/training/constraint-layout/index.html">Build a Responsive UI with
    ConstraintLayout</a>.
  </li>

  <li>The Layout Editor also now lets you create a list of <a href=
  "/studio/write/layout-editor.html#edit-properties">favorite attributes</a> so
  you don't have to click <b>View all attributes</b> to access the attributes
  you use most.
  </li>

  <li>When adding a material icon using the Vector Import Dialog (<b>File &gt;
  New &gt; Vector Asset</b>), you can now filter the list of available icons by
  category or by icon name. For more information, see <a href=
  "/studio/write/vector-asset-studio.html#materialicon">Adding a material
  icon</a>.
  </li>

  <li>
    <a href="/studio/write/annotations.html#accessibility">New and updated
    annotations</a>. The new <code>@RestrictTo</code> annotation for methods,
    classes, and packages lets you restrict an API. The updated
    <code>@VisibleForTesting</code> annotation now has an optional
    <code>otherwise</code> argument that lets you designate what the visibility
    of a method should be if not for the need to make it visible for testing.
    Lint uses the <code>otherwise</code> option to enforce the intended
    visibility of the method.
  </li>

  <li>New <a href="/studio/write/lint.html#snapshot">lint baseline support</a>
  allows you to use a snapshot of your project's current set of warnings as a
  baseline for future inspection runs so only new issues are reported. The
  baseline snapshot lets you start using lint to fail the build for new issues
  without having to go back and address all existing issues first.
  </li>

  <li>New lint checks, including the following:
    <ul>
      <li>Obsolete <code>SDK_INT</code> Checks: Android Studio removes obsolete
      code that checks for SDK versions.
      </li>
      <li>Object Animator Validation: Lint analyzes your code to make sure that
      your <code>ObjectAnimator</code> calls reference valid methods with the
      right signatures and checks that those methods are annotated with <code>
        @Keep</code> to prevent ProGuard from renaming or removing them during
        release builds.
      </li>
      <li>Unnecessary Item Decorator Copy: Older versions of the
      <code>RecyclerView</code> library did not include a divider decorator
      class, but one was provided as a sample in the support demos. Recent
      versions of the library have a divider decorator class. Lint looks for
      the old sample and suggests replacing it with the new one.
      </li>
      <li>WifiManager Leak: Prior to Android 7.0 (API level 24), initializing
      the <code>WifiManager</code> with <code><a href="/reference/android/content/Context.html#getSystemService(java.lang.Class&lt;T&gt;)">Context.getSystemService()</a></code>
      can cause a memory leak if the context is not the application context.
      Lint looks for these initializations, and if it <em>cannot</em> determine
      that the context is the application context, it suggests you use <code><a href="/reference/android/content/Context.html#getApplicationContext()">Context.getApplicationContext()</a></code> to get the proper context for the
      initialization.
      </li>
      <li>Improved Resource Prefix: The existing <code>resourcePrefix</code>
      lint check had many limitations. You can now configure your project with
      a prefix, such as <code>android { resourcePrefix '<var>my_lib</var>'
      }</code>, and lint makes sure that all of your resources are using this
      prefix. You can use variations of the name for styles and themes. For
      example for the <var>my_lib</var> prefix, you can have themes named
      <code>MyLibTheme</code>, <code>myLibAttr</code>,
      <code>my_lib_layout</code>, and so on.
      </li>
      <li>Switch to WebP: This check identifies images in your project that can
      be converted to WebP format based on your project’s
      <code>minSdkVersion</code> setting. An associated quickfix can
      automatically convert the images, or you can <a href=
      "/studio/write/convert-webp.html">convert images to WebP</a> manually.
      </li>
      <li>Unsafe WebP: If your project already includes WebP images, this check
      analyzes your project to ensure that your <code>minSdkVersion</code>
      setting is high enough to support the included images. For more
      information about WebP support in Android and Android Studio, see
      <a class="external" href=
      "https://developers.google.com/speed/webp/faq#which_web_browsers_natively_support_webp">
        Which browsers natively support WebP?</a> and <a href=
        "/studio/write/convert-webp.html">Create WebP Images Using Android
        Studio</a>.
      </li>
    </ul>
  </li>
</ul>

<h3 class="hide-from-toc">
  Changes
</h3>

<ul>
  <li>A separate button to push changes with Instant Run: After deploying your
  app, you now click <b>Apply Changes</b> <img src=
  "/studio/images/buttons/toolbar-apply-changes.svg" alt="" class=
  "inline-icon"> to quickly push incremental changes to your running app using
  Instant Run. The <b>Run</b> <img src="/studio/images/buttons/toolbar-run.png"
    alt="" class="inline-icon"> and <b>Debug</b> <img src=
    "/studio/images/buttons/toolbar-debug.png" alt="" class="inline-icon">
    buttons are always available to you when you want to reliably push your
    changes and force an app restart.
    <ul>
      <li>Instant Run is supported only when deploying your app to a target
      device running Android 5.0 (API level 21) or higher.
      </li>
      <li>Instant Run is no longer disabled for projects that <a href=
      "/studio/projects/add-native-code.html">link to external native
      projects</a> using CMake or ndk-build. However, you can only use Instant
      Run to push incremental changes to your Java code, not your native code.
      </li>
      <li>Cold swaps (which you can force for a running app by clicking
      <strong>Run</strong> <img src="/studio/images/buttons/toolbar-run.png"
      alt="" class="inline-icon">) are now more reliable. Forcing a cold swap
      also fixes the issue where changes to notification and widget UIs were
      not updated on the target device.
      </li>
      <li>Includes optimizations that make app startup much faster. These
      optimizations may affect profiling, so you should temporarily <a href=
      "/studio/run/index.html#disable-ir">disable Instant Run</a> whenever
      profiling your app.
      </li>
    </ul>
  </li>

  <li>
    <p>
      The <b>AVD Manager</b> <img src=
      "/studio/images/buttons/toolbar-avd-manager.png" alt="" class=
      "inline-icon"> and <b>SDK Manager</b> <img src=
      "/studio/images/buttons/toolbar-sdk-manager.png" alt="" class=
      "inline-icon"> buttons are now included in the lean Navigation Bar as
      well as the full Toolbar. To use the lean Navigation Bar, click
      <b>View</b> to open the View menu, then ensure that <b>Navigation Bar</b>
      is selected and <b>Toolbar</b> is <em>not</em> selected.
    </p>
    <img src="/studio/images/releases/navigationbar_sdkavd_2x.png" width="757">
  </li>

  <li>The "Hybrid" debugger has been renamed to "Dual" debugger.
  </li>

  <li>In the <a href="/studio/run/rundebugconfig.html">Run/Debug
  Configurations</a> dialog, under Defaults in the left pane, the following run
  configuration names have changed with no behavior changes:
    <ul>
      <li>The JUnit name has changed to Android JUnit. If you have a project
      that uses JUnit run configurations, those configurations are transformed
      to Android JUnit run configurations the first time you open the project
      with Android Studio. A dialog appears to inform you of the name change.
      </li>
      <li>The Android Tests name has changed to Android Instrumented Tests.
      </li>
    </ul>
  </li>

  <li>The <a href="/studio/debug/am-gpu-debugger.html">GPU Debugger</a> has
  been removed from Android Studio as of version 2.3. An open-source,
  standalone version of the tool is now available on <a href=
  "https://github.com/google/gapid" class="external-link">GitHub</a>.
  </li>

  <li>The Run/Debug option is no longer available when you right-click a <code>
    *.gradle build</code> script.
  </li>

  <li>All templates now use <code>ConstraintLayout</code> as the default
  layout.
  </li>

  <li>The Widgets palette in the Layout Editor has been redesigned.
  </li>
</ul>

<p>
  This release also includes a number of bug fixes. <a href=
  "https://code.google.com/p/android/issues/list?can=1&amp;q=target%3D2.3+status%3DReleased&amp;colspec=ID+Status+Priority+Owner+Summary+Stars+Reporter+Opened&amp;cells=tiles">
  See all bug fixes in 2.3.0.</a>
</p>

<p class="note">
  <b>Known issue:</b> Some device manufacturers block apps from automatically
  launching after being installed on the device. When deploying your app to a
  physical device using Android Studio 2.3, this restriction breaks the
  intended behavior of Instant Run and causes the following error output:
  <code>Error: Not found; no service started</code>. To avoid this issue,
  either <a href="/studio/run/emulator.html">use the emulator</a> or enable
  automatic launching for your app in your device's settings. The procedure
  for doing this is different for each device, so check the instructions
  provided by the manufacturer. To learn more about this issue, see
  <a href="https://code.google.com/p/android/issues/detail?id=235879">Issue
    #235879</a>.
</p>

2.2 (أيلول/سبتمبر 2016)

<p>
  This is a minor update to Android Studio 2.2. It includes a bug fixes
  focused around gradle, the core IDE, and lint.
</p>

<p>
  Highlighted build changes:
</p>

<ul>
  <li>ProGuard version rollback. Due to a <a href=
  "https://sourceforge.net/p/proguard/bugs/625/">correctness issue</a>
  discovered in ProGuard 5.3.1, we have rolled back to ProGuard 5.2.1. We
  have worked with the ProGuard team on getting a fix quickly, and we expect
  to roll forward to ProGuard 5.3.2 in Android Studio 2.3 Canary 3.
  </li>
  <li>Bug fix for <code>aaptOptions</code> <code>IgnoreAssetsPattern</code>
  not working properly (<a href="http://b.android.com/224167">issue
  224167</a>)
  </li>
  <li>Bug fix for Gradle autodownload for Constraint Layout library
    (<a href="https://code.google.com/p/android/issues/detail?id=212128">issue
    212128</a>)
  </li>
  <li>Bug fix for a JDK8/Kotlin compiler + dx issue (<a href=
  "http://b.android.com/227729">issue 227729</a>)
  </li>
</ul>

<p>
  <a href=
  "https://code.google.com/p/android/issues/list?can=1&amp;q=target%3D2.2.3+status%3AReleased+&amp;colspec=ID+Status+Priority+Owner+Summary+Stars+Reporter+Opened&amp;cells=tiles">
  See all bug fixes in 2.2.3</a>.
</p>

<p>
  This is a minor update to Android Studio 2.2. It includes a number of small
  changes and bug fixes, including:
</p>

<ul>
  <li>When reporting Instant Run issues through the IDE, the report now also
  includes logcat output for <code>InstantRun</code> events. To help us
  improve Instant Run, please <a href=
  "/studio/run/index.html#submit-feedback">enable extra logging and report
  any issues</a>.
  </li>
  <li>A number of small bug fixes for Gradle.
  </li>
  <li>A fix for problems with generating multiple APKs.
  </li>
</ul>

<p>
  This is a minor update to Android Studio 2.2. It includes several bug fixes
  and a new feature to enable extra logging to help us troubleshoot Instant
  Run issues—to help us improve Instant Run, please <a href=
  "/studio/run/index.html#submit-feedback">enable extra logging and report
  any issues</a>.
</p>

جديد

• محرر ملفّات تخطيطالجديد تمامًا الذي يتضمّن أدوات مصمّمة خصيصًا للتوافق مع ConstraintLayout

<li>New <strong><a href=
"http://tools.android.com/tech-docs/layout-inspector">Layout
Inspector</a></strong> lets you examine snapshots of your layout hierarchy
while your app is running on the emulator or a device.
</li>

<li>New <strong><a href="/studio/write/firebase.html">Assistant</a></strong>
window to help you integrate Firebase services into your app.
</li>

<li>New <strong><a href="/studio/debug/apk-analyzer.html">APK
Analyzer</a></strong> tool so you can inspect the contents of your packaged
app.
</li>

<li>New <strong><a href=
"http://tools.android.com/tech-docs/test-recorder">Espresso Test
Recorder</a></strong> tool (currently in beta) to help you create UI tests by
recording your own interactions.
</li>

<li>New <strong><a href=
"http://tools.android.com/tech-docs/build-cache">build cache</a></strong>
(currently experimental) to speed up build performance.
</li>

<li>New <strong>C/C++ build integration with CMake and ndk-build</strong>.
Compile and build new or existing native code into libraries packaged into
your APK, and debug using lldb. For new projects, Android Studio uses CMake
by default, but also supports ndk-build for existing projects. To learn how
to include native code in your Android application, read <a href=
"/studio/projects/add-native-code.html">Add C and C++ Code to Your
Project</a>. To learn how to debug native code with lldb, see <a href=
"/studio/debug/index.html#debug-native">Debug Native Code</a>.
</li>

<li>New <strong><a href="/studio/intro/index.html#sample-code">Samples
Browser</a></strong> so you can easily look up Google Android sample code
from within Android Studio to jump start app development.
</li>

<li>New <strong>Merged Manifest Viewer</strong> to help you diagnose how your
manifest file merges with your app dependencies across project build
variants.
</li>

<li>The <strong>Run</strong> window now contains log messages for the current
running app. Note that you can configure the <a href=
"/studio/debug/am-logcat.html">logcat Monitor</a> display, but not the
<strong>Run</strong> window.
</li>

<li>New <strong><a href="/studio/run/emulator.html">Android
Emulator</a></strong> features:
  <ul>
    <li>Added new <strong>Virtual</strong> <strong>Sensors</strong> and
    <strong>Cellular</strong> &gt; <strong>Signal Strength</strong> controls.
    </li>
    <li>Added an <strong>LTE</strong> option to the <strong>Cellular</strong>
    &gt; <strong>Network type</strong> control.
    </li>
    <li>Added simulated vertical swipes for scrolling through vertical menus
    with a mouse wheel.
    </li>
  </ul>
</li>

<li>New <strong><a href="/studio/run/rundebugconfig.html">Run/Debug
Configuration</a></strong> features:
  <ul>
    <li>The <strong>Debugger</strong> tab of the Android App and Android
    Tests templates now contain several new options for debugging with LLDB.
    </li>
    <li>The <strong>Profiling</strong> tab of the Android App and Android
    Tests templates now contain a <strong>Capture GPU Commands</strong>
    option for enabling GPU tracing. You can display GPU traces in the GPU
    Debugger (a beta feature).
    </li>
    <li>The Android Tests template now has a <strong>Firebase Test Lab Device
    Matrix</strong> option for the <strong>Deployment Target</strong>.
    </li>
    <li>The Native Application template has been deprecated. If you use this
    template in a project, Android Studio automatically converts it to the
    Android App template.
    </li>
    <li>The Android Application template has been renamed to Android App.
    </li>
  </ul>
</li>

<li>Improved installation, configuration, performance, and UI features in the
<strong><a href="/studio/debug/am-gpu-debugger.html">GPU
Debugger</a></strong> (currently in beta).
</li>

<li>Android Studio now comes bundled with <strong>OpenJDK 8</strong>.
Existing projects still use the JDK specified in <strong>File &gt; Project
Structure &gt; SDK Location</strong>. You can switch to use the new bundled
JDK by clicking <strong>File &gt; Project Structure &gt; SDK
Location</strong> and checking the <strong>Use embedded JDK</strong>
checkbox.
</li>

<li>Added new <strong>help menus and buttons</strong> in the UI so you can
more easily find the online documentation.
</li>

التغييرات

• تم تعديل قاعدة بيانات IDE من IntelliJ 15 إلى IntelliJ 2016.1
• تتطلّب ميزة "التشغيل الفوري" الآن تثبيت حزمة تطوير البرامج (SDK) لمنصّة التشغيل المتوافقة مع مستوى واجهة برمجة التطبيقات المستهدَف لجهازك.
• سيتم إيقاف ميزة "التشغيل الفوري" تلقائيًا إذا كان المستخدم يشغّل التطبيق باستخدام ملف عمل أو كمستخدم ثانوي.
• تم إصلاح العديد من مشاكل الموثوقية في ميزة التشغيل الفوري التي كانت تؤدي إلى عدم نشر التغيُّرات أو تعطُّل التطبيق:
  • لم يتم نشر بعض مواد عرض التطبيق في تطبيقك الذي يعمل. ( الخطأ: ‎#213454)
  • يتعطل التطبيق عند انتقال المستخدم بين جلسات "التشغيل الفوري" وجلسات التشغيل التي لا تتضمّن serialVersionUID في فئة Serializable. (الخطأ: ‎#209006)
  • لا تظهر تغييرات الأنماط عند استخدام ميزة "التشغيل الفوري". (الخطأ: ‎#210851)
  • جلسة "التشغيل الفوري" غير موثوقة وتؤدي إلى حدوث FileNotFoundException. (الخطأ: ‎#213083)
  • لا تظهر التغييرات التي يتم إجراؤها على ملفات drawable إلا بعد إجراء عملية إعادة إنشاء كاملة في نظام التشغيل KitKat. (الخطأ: ‎#21530)
  • لا تظهر تغييرات الموارد باستخدام ميزة "التشغيل الفوري" عندما تحتوي مجموعة sourceSets المخصّصة على مسارات متداخلة. (الخطأ: ‏#219145)
  • لا تعمل عملية التبديل السريع أو البديل إذا كانت الفئة التي تم تغييرها تحتوي على تعليق توضيحي مع قيمة مصنّف. (الخطأ: ‎#209047)
  • لا تظهر التغييرات التي تطرأ على بيانات التعليقات التوضيحية عند استخدام ميزة "التشغيل الفوري". (الخطأ: ‎#210089)
  • لا ترصد ميزة "التشغيل الفوري" تغييرات الرموز البرمجية إذا أجريت تغييرات خارج IDE. (الخطأ: ‎#213205)
  • جلسة "التشغيل الفوري" غير موثوق بها بسبب عدم تطابق الرمز المميّز للأمان. (الخطأ: ‎#211989
  • لا تنجح عملية التبديل البارد للأجهزة التي لا تتوافق مع run-as بشكل صحيح. (الخطأ: ‎#210875)
  • تعطُّل التطبيق بعد إعادة تشغيل ميزة "التشغيل الفوري" (الخطأ: ‏#219744)
  • تم رصد ClassNotFoundException عند التبديل من "التشغيل الفوري" إلى "تصحيح الأخطاء الفوري". (الخطأ: ‏#215805)

<li>Improved performance for <strong>Gradle sync</strong> within the IDE,
especially for large projects.
</li>

<li>Improved build times for both full and incremental builds with new app
packaging code.
</li>

<li>Improved <strong>Jack compiler performance and features</strong>,
including support for annotation processors and dexing in process. To learn
more, read the <a href=
"/studio/releases/gradle-plugin.html#revisions">Android plugin for Gradle
2.2.0 release notes</a>.
</li>

<li>Removed the <strong>Scale</strong> AVD property from the AVD Manager.
</li>

<li>The Android Emulator <strong>-port</strong> and <strong>-ports</strong>
command-line options now report which ports and serial number the emulator
instance is using, and warn if there are any issues with the values you
provided.
</li>

<li>Improved the <strong><a href=
"/studio/write/create-java-class.html">Create New Class dialog</a></strong>
and the corresponding file templates. <strong>Note:</strong> If you've
previously customized the <strong>AnnotationType</strong>,
<strong>Class</strong>, <strong>Enum</strong>, <strong>Interface</strong>, or
<strong>Singleton</strong> file templates, you need to modify your templates
to comply with the new templates or you won’t be able to use the new fields
in the <strong>Create New Class</strong> dialog.
</li>

<li>Improved the <strong><a href=
"/studio/write/vector-asset-studio.html">Vector Asset Studio</a></strong>
user interface and added support for Adobe Photoshop Document (PSD) files.
</li>

<li>Improved the <strong><a href=
"/studio/write/image-asset-studio.html">Image Asset Studio</a></strong> user
interface.
</li>

<li>Improved the <strong>Theme Editor</strong>'s Resource Picker.
</li>

<li>Fixed memory leaks and reduced overall memory usage in Android Studio.
</li>

<li>Added a <strong>Background</strong> button in the <strong><a href=
"/studio/intro/update.html#sdk-manager">SDK Manager</a></strong> so you can
get back to work and install your packages in the background.
</li>

<li>Improved <strong><a href="/studio/intro/accessibility.html">Accessibility
features</a></strong>, including support for screen readers and keyboard
navigation.
</li>

<li>Enhanced <strong>Code Analysis</strong> includes code quality checks for
Java 8 language usage and more cross-file analysis.
</li>

<li>Several toolbar icons have changed.
</li>

2.1 (نيسان/أبريل 2016)

توفّر التغييرات الأساسية في هذا التحديث إمكانية التطوير باستخدام إصدار Android N للمعاينة.

يضيف نظام Android N الأساسي إمكانية استخدام ميزات لغة Java 8، والتي تتطلّب بدورها استخدام مترجم تجريبي جديد يُسمى Jack. لا يتوفّر أحدث إصدار من Jack حاليًا إلا في Android Studio 2.1. لذلك، إذا كنت تريد استخدام ميزات لغة Java 8 ، عليك استخدام الإصدار 2.1 من "استوديو Android" لإنشاء تطبيقك.

ملاحظة: يتم إيقاف ميزة التشغيل الفوري عند تفعيل برنامج تجميع Jack لأنّه ليس متوافقًا حاليًا.

على الرغم من أنّ الإصدار 2.1 من "استوديو Android" أصبح ثابتًا الآن، لا يزال مجمع Jack تجريبيًا ويجب تفعيله باستخدام السمة jackOptions في ملف build.gradle.

بالإضافة إلى التغييرات التي تتيح استخدام الإصدار التجريبي من نظام التشغيل N، يتضمّن الإصدار 2.1 من Android Studio إصلاحات طفيفة للأخطاء والتحسينات التالية:

• تم تفعيل مصحِّح أخطاء C++ المتوافق مع Java تلقائيًا عند استخدام جهاز N أو محاكي واختيار وضع مصحِّح أخطاء الأداة الأصلية (في علامة التبويب مصحِّح الأخطاء لإعدادات التشغيل/تصحيح الأخطاء).

للحصول على تحسينات أخرى في عملية التصميم، بما في ذلك الترجمة المتزايدة لـ Java وإزالة الترميز أثناء التشغيل، عليك تحديث المكوّن الإضافي لنظام Android المتوافق مع IDE Gradle إلى الإصدار 2.1.0.

2.0 (نيسان/أبريل 2016)

ملاحظة: إذا كنت تُطوّر تطبيقات لإصدار N Developer Preview، عليك استخدام الإصدار التجريبي من "استوديو Android 2.1". لا يتيح الإصدار 2.0 من Android Studio جميع الميزات المطلوبة لاستهداف الإصدار التجريبي من نظام التشغيل N.

التشغيل الفوري:

• ينشر "استوديو Android" الآن عمليات الإنشاء النظيفة بشكل أسرع من أي وقت مضى. بالإضافة إلى ذلك، أصبح من الممكن الآن نقل التغييرات المتزايدة في الرموز إلى المحاكي أو جهاز فعلي بشكل فوري تقريبًا. مراجعة التعديلات بدون إعادة نشر ملف برمجي جديد لإصدار اختبار الأداة أو بدون إعادة تشغيل التطبيق في كثير من الحالات
• تتيح ميزة "التشغيل الفوري" تطبيق التغييرات التالية على تطبيق قيد التشغيل:
  • التغييرات في تنفيذ طريقة مثيل حالية أو طريقة ثابتة
  • التغييرات على مورد تطبيق حالي
  • التغييرات على الرمز الهيكلي، مثل توقيع الأسلوب أو الحقل static (يتطلب جهازًا مستهدَفًا يعمل بالمستوى 21 من واجهة برمجة التطبيقات أو إصدارًا أحدث)
• اطّلِع على المستندات لمعرفة مزيد من المعلومات عن ميزة "التشغيل الفوري".

  ملاحظة: لا يتم توفير ميزة التشغيل الفوري إلا عند نشر نسخة تصحيح الأخطاء، واستخدام مكوّن Android الإضافي للإصدار 2.0.0 من نظام التشغيل Android أو الإصدارات الأحدث، وضبط ملف build.gradle على مستوى وحدة تطبيقك للإصدار minSdkVersion 15 أو الإصدارات الأحدث. لتحقيق أفضل أداء، اضبط تطبيقك على الإصدار minSdkVersion 21 أو إصدار أحدث.

الإضافات الجديدة إلى Lint:

• فحص عبارات switch باستخدام أعداد صحيحة @IntDef مُشارَك عليها تعليقات توضيحية للتأكّد من أنّه تمّ التعامل مع جميع الثوابت لإضافة أي عبارات غير متوفّرة بسرعة، استخدِم القائمة المنسدلة لإجراءات القصد واختَر إضافة ثوابت @IntDef غير المتوفّرة.
• علامات للمحاولات غير الصحيحة لاستخدام إدراج السلسلة لإدراج أرقام الإصدار في ملف build.gradle
• علامات للفئات المجهولة التي تمدّد فئة Fragment
• الإبلاغ عن الرموز البرمجية الأصلية في أماكن غير آمنة، مثل المجلدَين res/ وasset/ وتشجع هذه العلامة على تخزين الرمز البرمجي الأصلي في مجلد libs/ ، والذي يتم بعد ذلك تجميعه بأمان في مجلد data/app-lib/ الخاص بالتطبيق في وقت التثبيت. AOSP:‏ #169950
• الإبلاغ عن المكالمات غير الآمنة إلى Runtime.load() وSystem.load() AOSP:‏ #179980
• ابحث عن أيّ موارد غير مستخدَمة وأزِلها من خلال اختيار إعادة التشكيل > إزالة الموارد غير المستخدَمة من شريط القوائم. تتيح ميزة رصد الموارد غير المستخدَمة الآن استخدام الموارد التي تتم الإشارة إليها فقط من خلال موارد غير مستخدَمة، والمراجع فيملفّات الأوّلية، مثل مراجع الصور .html، وسمات tools:keep و tools:discard التي يستخدمها أداة تصغير الموارد في Gradle، مع مراعاة مجموعات المصادر غير النشطة (مثل الموارد المستخدَمة في نكهات ملف الإنشاء الأخرى) والتعامل بشكل صحيح مع عمليات استيراد الحقول الثابتة.
• التحقّق من توفّر مراجع واجهة برمجة التطبيقات الضمنية على جميع المنصات التي تستهدفها minSdkVersion
• الإبلاغ عن استخدام غير ملائم لرمزَي RecyclerView وParcelable
• يتم الآن أيضًا التحقّق من عمليات فحص @IntDef و@IntRange و@Size بحثًا عن int الصفائف والمتغيّرات العشوائية.

تحسينات إضافية:

• تم تحسينه ليعمل على الإصدار 2.0 من "محاكي Android"، وهو أسرع من أي وقت مضى، ويتوافق مع مجموعة أكبر من الأجهزة الافتراضية، ويتميز بواجهة مستخدم محسّنة بشكل كبير. لمزيد من المعلومات عن المحاكي الجديد، يُرجى الاطّلاع على ملاحظات إصدار "أدوات حِزم تطوير البرامج (SDK)".
• تحسينات على مدير الأجهزة الافتراضية لنظام التشغيل Android:
  • تم تصنيف صور النظام الآن ضمن علامات التبويب التالية: مُقترَحة وx86 وغير ذلك.
  • ضمن الإعدادات المتقدّمة، يمكنك تفعيل ميزة التوافق مع المعالجات المتعددة وتحديد عدد النوى التي يمكن للمحاكي استخدامها.
  • ضمن الإعدادات المتقدّمة، يمكنك تحديد كيفية عرض الرسومات على المحاكي من خلال اختيار أحد الخيارَين التاليَين:
    • الأجهزة: استخدِم بطاقة الرسومات في جهاز الكمبيوتر لمعالجة المهام بشكل أسرع.
    • البرامج: استخدِم العرض المستنِد إلى البرامج.
    • تلقائي: يختار المحاكي الخيار الأفضل. وهذا هو الإعداد التلقائي.
• تم تحسين أوقات حزم AAPT من خلال تحديد هدف النشر قبل برمجة التطبيق. يتيح ذلك لخدمة Android Studio تجميع الموارد المطلوبة فقط للجهاز المحدّد بفعالية.
• تمت إضافة عملية دمج "مركز الاختبار الافتراضي في السحابة الإلكترونية" لتوفير اختبار التطبيقات عند الطلب مع الاستفادة من سهولة استخدام خدمة السحابة الإلكترونية وقابليتها للتوسع. مزيد من المعلومات حول كيفية استخدام "مختبر اختبارات الأداء في السحابة الإلكترونية" مع "استوديو Android"
• تمت إضافة معاينة لأداة تصحيح أخطاء وحدة معالجة الرسومات الجديدة. بالنسبة إلى التطبيقات التي تستخدم الرسومات بشكل مكثّف، يمكنك الآن الاطّلاع على رمز OpenGL ES visually لتحسين تطبيقك أو لعبتك.
• تمت إضافة اختبار "فهرسة التطبيقات من Google". يمكنك إضافة عناوين URL وميزة فهرسة التطبيقات ووظائف البحث إلى تطبيقاتك للمساعدة في جذب المزيد من الزيارات إلى تطبيقك ومعرفة محتوى التطبيق الأكثر استخدامًا وجذب مستخدمين جُدد. يمكنك اختبار عناوين URL في تطبيقك والتحقّق منها من خلال "استوديو Android Studio". اطّلِع على إتاحة عناوين URL وفهرسة التطبيقات في "استوديو Android".
• ترقيات من أحدث إصدار من IntelliJ 15، بما في ذلك تحليل الرمز البرمجي المحسَّن والأداء المحسَّن اطّلِع على الميزات الجديدة في IntelliJ للحصول على وصف كامل للميزات والتحسينات الجديدة.
• تضيف ميزة الإكمال التلقائي في محرِّر XML الآن علامات الاقتباس عند إكمال سمات. للتحقّق مما إذا كان هذا الخيار مفعّلاً، افتح مربّع الحوار الإعداد أو الإعدادات المفضّلة، وانتقِل إلى المحرِّر > عام > مفاتيح ذكية، وضَع علامة في المربّع بجانب إضافة علامات اقتباس لقيمة السمة عند اكتمال السمة. المشكلة: 195113
• يتيح محرِّر XML الآن إكمال الرموز البرمجية لتعبيرات ربط البيانات.

الإصدار 1.5.1 من "استوديو Android" (كانون الأول/ديسمبر 2015)

الإصلاحات والتحسينات:

• تم إصلاح مشكلة تعذُّر العرض في "محرر التنسيقات". المشكلة: 194612
• تمت إضافة إمكانية تغيير سمات بيان description حسب الإعداد. المشكلة: 194705
• تم تحسين التباين في مظهر Darcula في Android Studio في "استوديو مواد العرض الخاصة بالمتّجهات". المشكلة: 191819
• تمت إضافة زر المساعدة إلى "استوديو مواد العرض الخاصة بالمتّجهات".
• تمت إضافة عامل التشغيل % لربط البيانات. المشكلة: 194045
• تم إصلاح مشكلة كانت تؤدي إلى اتصال أداة تصحيح الأخطاء بالجهاز غير الصحيح عند تشغيل أحد التطبيقات لتصحيح الأخطاء. المشكلة: 195167
• تم إصلاح استثناء المؤشر غير الصالح الذي قد يحدث عند محاولة تشغيل تطبيق في سيناريوهات معيّنة.

الإصدار 1.5.0 من "استوديو Android" (تشرين الثاني/نوفمبر 2015)

الإصلاحات والتحسينات:

• تمت إضافة إمكانات تحليل جديدة في "مراقبة الذاكرة" إلى "مراقبة Android". عند عرض ملف HPROF تم تسجيله من هذه المراقبة، تكون الشاشة الآن أكثر فائدة حتى تتمكّن من تحديد المشاكل بسرعة أكبر، مثل تسرُّب الذاكرة. لاستخدام هذه الشاشة، انقر على شاشة Android في أسفل النافذة الرئيسية. في "مراقبة Android"، انقر على علامة التبويب الذاكرة. أثناء تشغيل أداة المراقبة، انقر على رمز تجميد ذاكرة Java، ثم انقر على عمليات الالتقاط في النافذة الرئيسية وانقر مرّتين على الملف لعرضه. انقر على تحليل التسجيل على يسار الصفحة. (لا يمكن تشغيل "أداة مراقبة أجهزة Android" في الوقت نفسه الذي يتم فيه تشغيل "أداة مراقبة Android").
• تمت إضافة ميزة جديدة تتيح استخدام الروابط لصفحات في التطبيق والروابط المؤدية إلى التطبيقات. يمكن لأداة "محرر الرموز" إنشاء فلتر أهداف تلقائيًا لإنشاء روابط لصفحات في التطبيق في ملف AndroidManifest.xml. ويمكنه أيضًا إنشاء رمز برمجي لمساعدتك في الدمج مع App Indexing API في نشاط في ملف Java. تساعدك ميزة اختبار الروابط لصفحات في التطبيق في التأكّد من أنّ رابطًا لصفحة في التطبيق محدّدًا يمكنه تشغيل تطبيق. في علامة التبويب عام ضمن مربّع الحوار إعدادات التشغيل/التصحيح، يمكنك تحديد خيارات تشغيل الرابط لصفحة في التطبيق. يمكنك أيضًا اختبار طلبات البيانات من واجهة برمجة التطبيقات App Indexing API في نشاط باستخدام شاشة logcat في "مراقبة Android". تتضمّن أداة lint لنظام التشغيل Android الآن تحذيرات بشأن مشاكل معيّنة تتعلّق بالروابط لصفحات في التطبيق وواجهة برمجة التطبيقات App Indexing API.
• تمت إضافة إمكانية استخدام أسماء قصيرة عند إكمال العروض المخصّصة باستخدام الرموز البرمجية في "محرر الرموز البرمجية".
• تمت إضافة المزيد من عناصر VectorDrawable إلى استوديو مواد العرض الخاصة بالمتّجهات لضمان التوافق مع الإصدارات القديمة. يمكن أن تستخدم أداة Vector Asset Studio هذه العناصر لتحويل مواد ّالعرض الموجّهة إلى صور نقطية بتنسيق PNG لاستخدامها مع الإصدار 4.4 من نظام التشغيل Android (المستوى 20 من واجهة برمجة التطبيقات) والإصدارات الأقدم.
• تمت إضافة عمليات فحص lint جديدة لنظامَي Android TV وAndroid Auto لتقديم ملاحظات فورية وقابلة للتنفيذ في Android Studio، بالإضافة إلى العديد من الإصلاحات السريعة. على سبيل المثال، بالنسبة إلى Android TV، يمكنه الإبلاغ عن المشاكل المتعلّقة بالأذونات والأجهزة غير المتوافقة ومحاولة حلّها بسرعة، وكذلك عن المشاكل المتعلّقة بعنصر uses-feature والإعلانات البانر غير المتوفّرة. بالنسبة إلى Android Auto، يمكنه التحقّق من الاستخدام الصحيح في ملف الوصف المُشار إليه من ملف AndroidManifest.xml، والإبلاغ في حال عدم توفّر فلتر أهداف لفئة MediaBrowserService، وتحديد مشاكل معيّنة في الإجراءات الصوتية.
• تمت إضافة عمليات تحقّق جديدة من lint لأجهزة استقبال البث غير الآمنة، وعمليات استخدام فئة SSLCertificateSocketFactory وHostnameVerifier، وعمليات استدعاء File.setReadable() وFile.setWritable(). ويرصد أيضًا عمليات البحث عن موارد البيان غير الصالحة، خاصةً للموارد التي تختلف حسب الإعداد.
• تم إصلاح عدد من المشاكل المتعلّقة بالثبات.

الإصدار 1.4.1 من "استوديو Android" (تشرين الأول/أكتوبر 2015)

الإصلاحات والتحسينات:

• تم إصلاح مشكلة في ذاكرة التخزين المؤقت لنموذج Gradle التي يمكن أن تؤدي إلى مزامنة Gradle بشكل مفرط عند إعادة تشغيل IDE.
• تم إصلاح مشكلة تتعلّق بتوقُّف تصحيح الأخطاء الأصلي.
• تم إصلاح مشكلة حظر مستخدمي نظام التحكّم في الإصدارات Subversion 1.9.
• تم إصلاح مشكلة في مربّع حوار أداة اختيار الأجهزة، حيث لم يعُد بإمكانك اختيار المحاكي بعد ربط جهاز غير مصرّح به. المشكلة: 189658
• تم إصلاح الإبلاغ عن أخطاء الترجمة غير الصحيحة للغات التي تحتوي على مؤهّل منطقة و translation في المنطقة (ولكن ليس في اللغة الأساسية). المشكلة: 188577
• تم إصلاح مشكلة في أداة تعديل التصميم تتعلّق بتفاعلها مع أداة تعديل التصميم. المشكلة: 188070
• تم إصلاح تعارض بين إعادة تحميل "أداة إنشاء المظاهر" وتعديلها، ما يؤدي إلى عدم تعديل السمات بشكلٍ صحيح. المشكلة: 187726
• تحسين أداء "محرر المظاهر"
• تم إصلاح مشكلة تجاهل سمة android:required في البيان. المشكلة: 187665

الإصدار 1.4.0 من "استوديو Android" (أيلول/سبتمبر 2015)

الإصلاحات والتحسينات:

• تمت إضافة أداة Vector Asset Studio لاستيراد الرسومات المتجهّة، مثل رموز المواد وملفات SVG. لاستخدام هذه الأداة، في عرض Android من نافذة المشروع، انقر بزر الماوس الأيمن على مجلّد res واختَر جديد > أصل رسومات متحركة.
• تمت إضافة وظائف جديدة لمراقبة Android ووحدة معالجة الرسومات والشبكة. لاستخدام هذه الشاشات، انقر على شاشة Android في أسفل النافذة الرئيسية. لا يمكن تشغيل "أداة مراقبة أجهزة Android" في الوقت نفسه الذي يتم فيه تشغيل "أداة مراقبة Android".
• تمت إضافة معاينة مبكرة لأداة "محرر المظاهر" الجديدة. لاستخدام هذه الميزة، اختَر الأدوات > Android > محرر المظاهر.
• تم تعديل نماذج Android في "مكتبة دعم التصميم". تتضمّن النماذج الآن دعمًا لمواصفات Material Design، بالإضافة إلى appcompat مكتبة الدعم للتوافق مع الإصدارات القديمة.

الإصدار 1.3.2 من "استوديو Android" (أغسطس 2015)

الإصلاحات والتحسينات:

• تمت إضافة إمكانية استخدام نظام التشغيل Android 6.0 (المستوى 23 من واجهة برمجة التطبيقات)، بما في ذلك الرموز الجديدة ومدير AVD إمكانية إنشاء أجهزة بكثافات شاشة جديدة.
• تم إصلاح استثناء كان يحدث أثناء عمليات التحقّق من التحديثات. المشكلة: 183068
• تم حلّ المشكلة التي كانت تؤدي إلى تعطُّل "محرر التنسيق" بسبب عدم حلّ إحداثيات العرض. المشكلة: 178690
• تم إصلاح مشكلة التحذيرات بشأن أنواع الموارد غير الصالحة. المشكلة: 182433
• تم إصلاح فحص الأخطاء الذي كان يُبلغ عن الموارد بشكل غير صحيح على أنّها خاصة. المشكلة: 183120

الإصدار 1.3.1 من "استوديو Android" (آب/أغسطس 2015)

الإصلاحات والتحسينات:

• تم إصلاح مشكلة عدم توفّر إمكانية إنشاء جهاز Android Wear افتراضي (AVD) على نظام التشغيل Windows.
• تم تعديل معالج المشاريع لاستخدام اسم المشروع الذي أدخلته.
• تمت إضافة ميزة للسماح بتخزين حزمة تطوير البرامج (SDK) لنظام التشغيل Android في دليل للقراءة فقط.
• تم تحديث الإصدار 1.3.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.
• تم إصلاح المشاكل المتعلقة ببدء جلسة تصحيح أخطاء من shell لنظام التشغيل Unix في أداة Android Debug Bridge (adb).
• تم إصلاح رسالة إعادة تسمية حزمة Java لعرض اسم الحزمة الصحيح.

الإصدار 1.3.0 من "استوديو Android" (تموز/يوليو 2015)

الإصلاحات والتحسينات:

• تمّت إضافة خيارات لتفعيل خدمات المطوّرين، مثل Google AdMob و إحصاءات Google، في تطبيقك من داخل IDE Android Studio.
• إضافة تعليقات توضيحية إضافية، مثل @RequiresPermission و@CheckResults و @MainThread
• تمت إضافة إمكانية إنشاء نُسخ تخزين مؤقت لمساحة Java وتحليل عمليات تخصيص الخيوط من مراقب الذاكرة. يمكنك أيضًا استخدام IDE في Android Studio لتحويل ملفات تنسيق HPROF الثنائي الخاصة بنظام التشغيل Android إلى تنسيق HPROF العادي.
• تم دمج مدير حِزم تطوير البرامج (SDK) في Android Studio لتبسيط الوصول إلى الحِزم والأدوات وتقديم إشعارات بشأن التحديثات.

  ملاحظة: لا يزال "مدير حِزم SDK" المستقل متاحًا من سطر الأوامر، ولكن يُنصح باستخدامه مع عمليات تثبيت حِزم SDK المستقلة فقط.

• تمت إضافة الأمر finger في وحدة تحكّم المحاكي لمحاكاة مصادقة بصمة الإصبع
• تمت إضافة بيان مورد <public> لتحديد موارد المكتبة على أنّها موارد عامة وخاصة.

  ملاحظة: يتطلب الإصدار 1.3 أو إصدارًا أحدث من المكوّن الإضافي المتوافق مع Android لنظام Gradle.

• تمت إضافة ميزة ربط البيانات لأجل إنشاء تنسيقات توضيحية تربط منطق تطبيقك بعناصر التنسيق.
• تمت إضافة إمكانية استخدام وحدة حزمة APK اختبارية منفصلة لإنشاء حِزم APK اختبارية في Android Studio.
• تم تعديل مدير AVD من خلال تحسينات HAXM وإشعارات محسّنة.
• تمت إضافة دعم لمحاكي ARM وMIPS بإصدار 64 بت لإصدار QEMU 2.1.
• تم تبسيط حلّ تحذيرات Lint من خلال إضافة إصلاحات سريعة، مثل إنشاء Parcelable تلقائيًا.
• تمت إضافة ميزة إدراج مقتطفات الرموز البرمجية بسرعة في النماذج المباشرة.

الإصدار 1.2.2 من "استوديو Android" (يونيو 2015)

الإصلاحات والتحسينات:

• تم إصلاح مشاكل الإنشاء التي كانت تمنع اكتمال عمليات الإنشاء.

الإصدار 1.2.1 من "استوديو Android" (مايو 2015)

الإصلاحات والتحسينات:

• تم إصلاح مشاكل بسيطة في الأداء والميزات.

الإصدار 1.2.0 من "استوديو Android" (نيسان (أبريل) 2015)

الإصلاحات والتحسينات:

• تم تعديل نافذة وقت تشغيل Android لتضمين أداة مراقبة الذاكرة وإضافة علامة تبويب لمراقبة أداء وحدة المعالجة المركزية.
• تمت إضافة علامة التبويب عمليات الالتقاط في الهامش الأيمن لعرض ملفّات بيانات أداء الذاكرة ووحدة المعالجة المركزية التي تمّ التقاطها، مثل تتبُّع طريقة وحدة المعالجة المركزية وملخّصات ذاكرة الشريحة.
• توسيع نطاق التعليقات التوضيحية مع التعليقات التوضيحية الإضافية للبيانات الوصفية وإمكانية تحديد ما إذا كان الحقل فارغًا أم لا
• تم تحسين "محرر الترجمة" من خلال إضافة ميزة إضافية تتوافق مع أفضل الممارسات الحالية (BCP) 47، والتي تستخدم رموزًا مكوّنة من 3 أحرف للّغة والمنطقة.
• ميزات IntelliJ 14 و14.1 المدمجة لتحسين تحليل الرموز البرمجية وأدائها:
• • تصحيح أخطاء محسّن لعرض القيم المضمّنة للمتغيّرات والعناصر المشار إليها، بالإضافة إلى إجراء تقييم مضمّن لتعبيرات عاملي lambda
  • تمت إضافة ميزة رصد نمط الرمز لأحجام علامات التبويب والمسافات البادئة.
  • تمت إضافة ملفات فارغة لتجارب الرموز البرمجية وإنشاء النماذج الأولية بدون ملفات المشاريع.
  • تمت إضافة إدراج علامات الفتح والإغلاق في وقتٍ واحد فيملفَي HTML وXML.
  • تمت إضافة أداة فك ترميز فئة Java مدمجة حتى تتمكّن من الاطّلاع على محتويات مكتبة لا يتوفّر لها رمز المصدر.

  اطّلِع على الميزات الجديدة في IntelliJ للحصول على وصف كامل للميزات والتحسينات الجديدة.

• تمت إضافة طرق عرض المشروع إضافية لملفّات التصاميم الأولية وملفات المشروع والمشاكل والإصدار العلني والاختبارات لتحسين إدارة المشروع وإمكانية الوصول إليه.
• تم تحسين قائمة الملف > الإعدادات وملفات الحوار لتحسين إمكانية الوصول إلى الإعدادات وإدارتها.
• تمّت إضافة ميزة التوافق مع شاشات عالية الكثافة لنظامَي التشغيل Windows وLinux.
• تمت إضافة إمكانية استخدام ملفات بدقة 280 نقطة في البوصة في المجلد res/drawable-280dpi/.

الإصدار 1.1.0 من "استوديو Android" (شباط/فبراير 2015)

إصلاحات وتحسينات متنوّعة:

• تمت إضافة إمكانية استخدام نموذج ساعة Android Wear.
• تم تعديل عملية إنشاء المشاريع والوحدات الجديدة لتضمين مجلدات res/mipmap لرمز التمهيد الخاص بكثافة الشاشة. تستبدل مجلدات res/mipmap هذه المجلدات res/drawable الخاصة برموز مشغّل التطبيقات.
• تم تعديل رموز مشغّل التطبيقات لتتضمّن مظهرًا يتوافق مع مبادئ التصميم المتعدّد الأبعاد، كما تمت إضافة رمز مشغّل التطبيقات xxxhdpi.
• تمّت إضافة عمليات تحقّق وتحسينات في Lint لمجموعات المناطق واللغات ورموز مشغّل التطبيقات وأسماء الموارد وغيرها من المشاكل المشترَكة في الرموز البرمجية.
• تمت إضافة علامة اللغة 47 وفقًا لأفضل الممارسات الحالية (BCP).

الإصدار 1.0.1 من "استوديو Android" (كانون الأول/ديسمبر 2014)

إصلاحات وتحسينات متنوّعة:

• تم إصلاح مشكلة قفل ملف device.xml ومدير AVD.
• تم إصلاح سجلّ المحاكي على أنظمة التشغيل Windows.
• تم حلّ مشكلة إنشاء أجهزة افتراضية Android (AVD) باستخدام Android Studio وحزمة تطوير البرامج (SDK) لنظام التشغيل Android المثبَّتَين على محركَي أقراص مختلفَين على أنظمة التشغيل Windows.
• ضبط قناة التحديث التلقائية لعمليات التنزيل الجديدة على الإصدار الثابت إذا ثبَّت إصدار 1.0.0 من Android Studio وأردت الحصول على تحديثات إصدار ثابتة وجاهزة للنشر، يمكنك استخدام ملف > الإعدادات > التحديثات للانتقال إلى قناة التحديث الثابت.

الإصدار 1.0 من "استوديو Android" (كانون الأول/ديسمبر 2014)

الإصدار الأولي من "استوديو Android"

الإصدار 0.8.14 من "استوديو Android" (تشرين الأول/أكتوبر 2014)

يُرجى الانتقال إلى tools.android.com للاطّلاع على قائمة كاملة بالتغييرات.

الإصدار 0.8.6 من Android Studio‏ (أغسطس 2014)

يُرجى الانتقال إلى tools.android.com للاطّلاع على قائمة كاملة بالتغييرات.

الإصدار 0.8.0 من "استوديو Android" (يونيو 2014)

تمت إضافة إمكانية استخدام مشاريع Android Wear.

يُرجى الانتقال إلى tools.android.com للاطّلاع على قائمة كاملة بالتغييرات.

الإصدار 0.5.2 من "استوديو Android" (مايو 2014)

• يُرجى الانتقال إلى tools.android.com للاطّلاع على قائمة كاملة بالتغييرات.

الإصدار 0.4.6 من "استوديو Android" (آذار/مارس 2014)

• يُرجى الانتقال إلى tools.android.com للاطّلاع على قائمة كاملة بالتغييرات.

الإصدار 0.4.2 من "استوديو Android" (كانون الثاني (يناير) 2014)

• يُرجى الانتقال إلى tools.android.com للاطّلاع على قائمة كاملة بالتغييرات.

الإصدار 0.3.2 من "استوديو Android" (تشرين الأول/أكتوبر 2013)

• يُرجى الانتقال إلى tools.android.com للاطّلاع على قائمة كاملة بالتغييرات.

الإصدار 0.2.x من "استوديو Android" (تموز/يوليو 2013)

• تم دمج أحدث التغييرات في قاعدة بيانات IntelliJ. تتضمّن إصلاحات للمشاكل التي أبلغ عنها مستخدمو Studio، مثل التعديلات على أحجام الخطوط وعرض الخطوط في Linux.
• تم تحديث المكوّن الإضافي لنظام Gradle المتوافق مع Android إلى الإصدار 0.5.0.

  تحذير: لا يتوافق هذا الإصدار الجديد مع الإصدارات القديمة. عند فتح مشروع يستخدم إصدارًا قديمًا من المكوّن الإضافي، سيعرض "استوديو YouTube" رسالة خطأ مفادها تعذّر إعادة تحميل مشروع Gradle‏ <project_name>.

  يتضمّن مكوّن Gradle الإضافي المعدَّل التغييرات التالية:

  • تم إصلاح نموذج IDE ليحتوي على ملف الإخراج حتى إذا تم تخصيصه من خلال لغة وصف البيانات. تم أيضًا حلّ مشكلة لغة الترميز المحدودة (DSL) للحصول على ملف الإخراج أو ضبطه في عنصر الصيغة، ما يجعل استخدام العنصر variant.packageApplication or variant.zipAlign غير ضروري.
  • تم إصلاح عملية حلّ التبعيات لكي نتمكّن من حلّ مجموعة (الإعداد التلقائي، أنواع الإنشاء، النكهات) معًا بدلاً من حلّها بشكل منفصل.
  • تم إصلاح مشكلة التبعية لاختبارات مشروع المكتبة لتضمين جميع تبعات المكتبة نفسها بشكل صحيح.
  • تم إصلاح الحالة التي يكون فيها اسم الورقة هو نفسه في عنصرَي الاعتماد.
  • تم إصلاح مشكلة تعذُّر تطبيق ملف قواعد Proguard على النُسخ المخصّصة.

  تتوفّر جميع ملاحظات الإصدار الخاصة بالمكوّن الإضافي لنظام Gradle على الرابط التالي: http://tools.android.com/tech-docs/new-build-system.

• لم تعُد أخطاء Gradle من aapt تشير إلى ملفات الإخراج المدمجة في مجلد build/ ‎، ولكنها تشير إلى مواقع المصدر الفعلية.
• عمليات الإنشاء المتوازي أصبح من الممكن الآن استخدام عمليات الإنشاء المتوازي في Gradle. يُرجى العِلم أنّه لا تزال عمليات الإنشاء المتوازي في مرحلة "الحاضنة" (اطّلِع على مستندات IDE IDE في Gradle). هذه الميزة غير مفعّلة تلقائيًا. لتفعيل هذه الميزة، انتقِل إلى الإعدادات المفضّلة > المجمِّع وضَع علامة في المربّع تجميع الوحدات المستقلة بشكل موازٍ.
• المزيد من العمل على مستودع الموارد الجديد المستخدَم لعرض التنسيق وجمع الموارد وتسويتها في المحرِّر وغير ذلك:
  • دعم أساسي لتبعيات مكتبة ‎.aar (مثل استخدام مكتبة بدون نسخة محلية من المصادر) لا تزال هذه الميزة غير متاحة للتحقّق من صحة ملفات XML الخاصة بالموارد والتنقّل فيها في محرّري المصادر.
  • رصد دورة في مراجع الموارد
  • ميزة "المستندات السريعة" (F1)، التي يمكنها عرض جميع ترجمات السلسلة تحت السهم، ستعرض الآن أيضًا جميع عمليات تراكب الموارد من أنواع Gradle وأنواع الإنشاء المختلفة، بالإضافة إلى المكتبات. ويتم إدراجها بترتيب عكسي لمحتوياتها، مع وضع خط مُمحي على نُسخ السلسلة التي تم حجبها.
  • إصلاحات للتعامل مع تعديل الموارد المدمجة عند تغيير مجموعة تبعيات الوحدات
  • إصلاحات في عرض XML للتعامل بشكل صحيح مع بيانات كيان الأحرف وعلامات XML وUnicode للإفلات
• إتاحة حفظ لقطة شاشة لنوافذ معاينة التنسيق ومحرّر التنسيق
• إصلاحات أخطاء النماذج
• إصلاحات أخطاء Lint
• إصلاحات متنوّعة لتقارير الأعطال شكرًا لك، ويُرجى مواصلة إرسال تقارير الأعطال.

الإصدار 0.1.x من "استوديو Android" (مايو 2013)

• إصلاحات مختلفة للأخطاء، بما في ذلك إصلاح مشكلة شائعة في تثبيت Windows

3.6.0 (شباط/فبراير 2020)

يتطلّب هذا الإصدار من المكوّن الإضافي لنظام Android ما يلي:

• Gradle 5.6.4 لمزيد من المعلومات، يُرجى الاطّلاع على القسم حول تحديث Gradle.

• أدوات إنشاء حِزم SDK 28.0.3 أو إصدار أحدث

الميزات الجديدة

يتضمّن هذا الإصدار من المكوّن الإضافي لنظام Gradle المتوافق مع Android الميزات الجديدة التالية:

عرض الربط

يضمن ربط العناصر أمان وقت الترجمة عند الإشارة إلى العناصر في الرمز البرمجي. يمكنك الآن استبدال findViewById() بمرجع فئة الربط المنشأة تلقائيًا. لبدء استخدام ربط العناصر المرئية، أدرِج ما يلي في ملف build.gradle لكل وحدة:

      android {
          viewBinding.enabled = true
      }
      

      android {
          viewBinding.enabled = true
      }
      

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات ربط View.

إتاحة المكوّن الإضافي Maven Publish

يتضمّن المكوّن الإضافي لنظام Gradle المتوافق مع Android مكوّن Maven Publish Gradle الإضافي الذي يتيح لك نشر عناصر الإنشاء في مستودع Apache Maven. ينشئ المكوّن الإضافي لـ Android Gradle مكوّنًا لكل عنصر من عناصر الصيغة في تطبيقك أو وحدة مكتبتك، ويمكنك استخدامه لتخصيص نشر في مستودع Maven.

لمزيد من المعلومات، انتقِل إلى صفحة كيفية استخدام المكوّن الإضافي Maven Publish.

أداة جديدة للحزم التلقائية

عند إنشاء إصدار تصحيح الأخطاء من تطبيقك، يستخدم المكوّن الإضافي أداة حزم جديدة تُسمى zipflinger لإنشاء حزمة APK. من المفترض أن تؤدي هذه الأدوات الجديدة إلى تحسين سرعة إنشاء الإصدارات. إذا لم تعمل أداة الحزمة الجديدة على النحو المتوقّع، يُرجى الإبلاغ عن خطأ. يمكنك الرجوع إلى استخدام أداة الحزمة القديمة من خلال تضمين ما يلي في ملف gradle.properties:

        android.useNewApkCreator=false
      

تحديد مصدر الإصدار الأصلي

يمكنك الآن تحديد المدة التي يستغرقها Clang لإنشاء كل ملف C/C++ في مشروعك و الربط به. يمكن أن يُخرج Gradle تتبع Chrome الذي يحتوي على الطوابع الزمنية لأحداث المُجمِّع هذه حتى تتمكّن من معرفة الوقت المطلوب لإنشاء مشروعك بشكل أفضل. لإخراج ملف تحديد المصدر هذا، اتّبِع الخطوات التالية:

1. أضِف العلامة -Pandroid.enableProfileJson=true عند تشغيل عملية إنشاء Gradle. مثلاً:

   gradlew assembleDebug -Pandroid.enableProfileJson=true

2. افتح متصفّح Chrome واكتب chrome://tracing في شريط البحث.

3. انقر على الزر تحميل وانتقِل إلى <var>project-root</var>/build/android-profile للعثور على الملف. اسم الملف هو profile-<var>timestamp</var>.json.gz.

يمكنك الاطّلاع على بيانات تحديد مصدر الإصدار المضمّن بالقرب من أعلى أداة المشاهدة:

تغييرات السلوك

عند استخدام هذا الإصدار من المكوّن الإضافي، قد تلاحظ التغييرات التالية في السلوك.

المكتبات الأصلية المُجمَّعة غير المضغوطة تلقائيًا

عند إنشاء تطبيقك، يضبط المكوّن الإضافي الآن قيمة extractNativeLibs على "false" تلقائيًا. وهذا يعني أنّ المكتبات الأصلية تكون محاذية للصفحة ومُجمَّعة بدون ضغط. على الرغم من أنّ ذلك يؤدي إلى زيادة حجم التحميل، يستفيد المستخدمون من ما يلي:

• حجم أصغر لتثبيت التطبيق لأنّ النظام الأساسي يمكنه الوصول إلى مكتبات التشغيل الأصلية مباشرةً من حزمة APK المثبَّتة، بدون إنشاء نسخة من مكتبات التشغيل
• حجم تنزيل أصغر لأنّ ضغط متجر Play يكون عادةً أفضل عند تضمين مكتبات غير مضغوطة مجمّعة من رموز برمجية أصلية في ملف APK أو حِزمة تطبيق Android.

إذا كنت تريد أن تحزِّم "مكوّن إضافي لـ Gradle في Android" المكتبات المُجمَّعة من رموز برمجية أصلية بدلاً من ذلك، أدرِج ما يلي في ملف بيان تطبيقك:

        <application
          android:extractNativeLibs="true"
          ... >
        </application>
        
      

ملاحظة: تم استبدال سمة extractNativeLibs manifest بخيار useLegacyPackaging DSL. لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات الإصدار استخدام لغة وصف البيانات لحزمة المكتبات المدمجة الأصلية.

إصدار NDK التلقائي

في حال تنزيل إصدارات متعدّدة من حزمة NDK، سيختار الآن المكوّن الإضافي لنظام Gradle في Android إصدارًا تلقائيًا لاستخدامه في تجميع ملفات الرموز المصدر. في السابق، كان المكوّن الإضافي يختار أحدث إصدار تم تنزيله من حِزم NDK. استخدِم السمة android.ndkVersion في ملف build.gradle الخاص بالوحدة لتجاهل الإعداد التلقائي الذي اختاره المكوّن الإضافي.

إنشاء فئة R مبسّطة

يعمل المكوّن الإضافي لنظام Android Gradle على تبسيط مسار تجميع الرموز البرمجية من خلال إنشاء فئة R واحدة فقط لكل وحدة مكتبة في مشروعك و مشاركة فئات R هذه مع الوحدات الأخرى التي تعتمد عليها. من المفترض أن يؤدّي هذا التحسين إلى إنشاء إصدارات أسرع، ولكن يجب مراعاة ما يلي:

• بما أنّ المُجمِّع يشارك فئات R مع تبعيات الوحدات في المصدر، من المهم أن تستخدم كل وحدة في مشروعك اسم حزمة فريدًا.
• يتم تحديد مستوى وصول فئة R في المكتبة إلى العناصر الاعتمادية الأخرى للمشروع من خلال الإعدادات المستخدَمة لتضمين المكتبة كأحد عناصر الاعتماد. على سبيل المثال، إذا كانت المكتبة "أ" تتضمّن المكتبة "ب" كتبعية لـ "واجهة برمجة التطبيقات"، يمكن للمكتبة "أ" والمكتبات الأخرى التي تعتمد على المكتبة "أ" الوصول إلى فئة R في المكتبة "ب". ومع ذلك، قد لا تملك المكتبات الأخرى إذن الوصول إلى فئة R في المكتبة "ب". إذا كانت المكتبة "أ" تستخدم إعدادات التبعية implementation. للاطّلاع على مزيد من المعلومات، يمكنك الاطّلاع على إعدادات التبعيات.

إزالة الموارد غير المتوفّرة في الإعدادات التلقائية

بالنسبة إلى وحدات المكتبة، إذا أدرجت موردًا للغة لا تدرجها في المجموعة التلقائية من الموارد، على سبيل المثال، إذا أدرجت hello_world كمورد سلسلة في /values-es/strings.xml ولكنك لم تحدِّد هذا المورد في /values/strings.xml، لن يضمِّن المكوّن الإضافي لـ Android Gradle هذا المورد عند تجميع مشروعك. من المفترض أن يؤدّي تغيير السلوك هذا إلى تقليل عدد Resource Not Found استثناءات وقت التشغيل وتحسين سرعة التصميم.

يراعي D8 الآن سياسة الاحتفاظ ببيانات CLASS للتعليقات التوضيحية.

عند تجميع تطبيقك، يراعي الإصدار D8 الآن الحالات التي تطبّق فيها التعليقات التوضيحية سياسة الاحتفاظ بـ CLASS ، ولا تعود هذه التعليقات التوضيحية متاحة عند التشغيل. ويظهر هذا السلوك أيضًا عند ضبط حزمة تطوير البرامج (SDK) المستهدَفة للتطبيق على المستوى 23 لواجهة برمجة التطبيقات، والذي كان يسمح سابقًا بالوصول إلى هذه التعليقات التوضيحية أثناء وقت التشغيل عند تجميع تطبيقك باستخدام إصدارات قديمة من "مكوّن Android Gradle Plugin" وD8.

تغييرات السلوك الأخرى

• لم يعُد aaptOptions.noCompress حسّاسًا لحالة الأحرف على جميع الأنظمة الأساسية (لكل من حِزم APK والحِزم) ويراعي المسارات التي تستخدم أحرفًا كبيرة.

• أصبح ربط البيانات متزايدًا تلقائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على المشكلة رقم 110061530.

• يمكن الآن تخزين جميع اختبارات الوحدات، بما في ذلك اختبارات Roboelectric، في ذاكرة التخزين المؤقت بالكامل. لمزيد من المعلومات، يُرجى الاطّلاع على المشكلة رقم 115873047.

إصلاح الأخطاء

يتضمّن هذا الإصدار من المكوّن الإضافي لنظام Gradle المتوافق مع Android إصلاحات الأخطاء التالية:

• أصبحت اختبارات Robolectric للوحدات متاحة الآن في وحدات المكتبة التي تستخدم عملية ربط البيانات. لمزيد من المعلومات، يُرجى الاطّلاع على المشكلة رقم 126775542.
• يمكنك الآن تنفيذ مهام connectedAndroidTest على مستوى وحدات متعددة عندما يكون وضع التنفيذ المتزامن في Gradle مفعّلاً.

المشاكل المعروفة

يوضّح هذا القسم المشاكل المعروفة في المكوّن الإضافي لنظام Gradle المتوافق مع Android 3.6.0.

بطء أداء مهمة Android Lint

قد يستغرق إكمال عملية فحص Android Lint وقتًا أطول بكثير في بعض المشاريع بسبب التراجع في البنية الأساسية للتحليل، ما يؤدي إلى تباطؤ عملية احتساب الأنواع المستنتجة للوظائف المجهولة في بنى رموز معيّنة.

تم الإبلاغ عن المشكلة على أنّها خطأ في IDEA وسيتم حلّها في الإصدار 4.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android.

عدم توفّر فئة البيان {:#agp-missing-manifest}

إذا كان تطبيقك يحدِّد أذونات مخصّصة في بيانه، ينشئ المكوّن الإضافي Gradle لنظام Android عادةً فئة Manifest.java تشمل أذوناتك المخصّصة بصفتها ثوابت سلاسل. يُحزم المكوّن الإضافي هذه الفئة مع تطبيقك، ما يتيح لك الإشارة إلى هذه الأذونات بسهولة أكبر أثناء التشغيل.

لا يمكن إنشاء فئة البيان في الإصدار 3.6.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android. إذا أنشأت تطبيقك باستخدام هذا الإصدار من المكوّن الإضافي، وكان يشير إلى فئة البيان، قد يظهر لك استثناء ClassNotFoundException. لحلّ هذه المشكلة، يمكنك تنفيذ أحد الإجراءات التالية:

• يمكنك الإشارة إلى أذوناتك المخصّصة باسمها المحدَّد بالكامل. على سبيل المثال، "com.example.myapp.permission.DEADLY_ACTIVITY".

• حدِّد الثوابت الخاصة بك كما هو موضّح أدناه:

              public final class CustomPermissions {
                public static final class permission {
                  public static final String DEADLY_ACTIVITY="com.example.myapp.permission.DEADLY_ACTIVITY";
                }
              }
              
            

3.5.0 (آب/أغسطس 2019)

يُعدّ الإصدار 3.5.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android، بالإضافة إلى استوديو Android 3.5، إصدارًا رئيسيًا ونتيجةً لمشروع Marble الذي يركز على تحسين ثلاثة جوانب رئيسية في أدوات مطوّري تطبيقات Android، وهي حالة النظام وتحسين الميزات وإصلاح الأخطاء. يُرجى العِلم أنّه تم التركيز بشكل أساسي في هذا التعديل على تحسين سرعة إنشاء المشروعات.

للحصول على معلومات عن هذه التعديلات وغيرها من التعديلات على Project Marble، يمكنك الاطّلاع على مشاركة المدونة الخاصة بمطوّري تطبيقات Android أو الأقسام أدناه.

يتطلّب هذا الإصدار من المكوّن الإضافي لنظام Android ما يلي:

• Gradle 5.4.1 لمزيد من المعلومات، يُرجى الاطّلاع على القسم المعنيّ بموضوع تحديث Gradle.

• أدوات إنشاء حِزم SDK 28.0.3 أو إصدار أحدث

معالجة التعليقات التوضيحية المتزايدة

تتيح وحدة معالجة التعليقات التوضيحية في ربط البيانات معالجة التعليقات التوضيحية المتزايدة إذا تم ضبط android.databinding.incremental=true فيملف gradle.properties. يؤدّي هذا التحسين إلى تحسين أداء الإنشاء المتزايد. للحصول على قائمة كاملة بمعالجات التعليقات التوضيحية المحسّنة، يُرجى الرجوع إلى جدول معالجات التعليقات التوضيحية المتزايدة.

بالإضافة إلى ذلك، تتيح الإصدارات 1.3.30 من KAPT والإصدارات الأحدث أيضًا معالجات التعليقات التوضيحية المتصاعدة، والتي يمكنك تفعيلها عن طريق تضمين kapt.incremental.apt=true فيملف gradle.properties.

اختبارات الوحدة القابلة للتخزين المؤقت

عند تفعيل اختبارات الوحدة لاستخدام موارد Android ومواد العرض والملفات التعريفية من خلال ضبط includeAndroidResources على true، ينشئ المكوّن الإضافي لنظام Gradle المتوافق مع Android ملف إعدادات اختبار يحتوي على مسارات مطلقة، ما يؤدي إلى إيقاف إمكانية إعادة تحديد موقع ذاكرة التخزين المؤقت. يمكنك توجيه الإضافة لإنشاء إعدادات الاختبار بدلاً من ذلك باستخدام المسارات النسبية، ما يتيح تخزين مهمة AndroidUnitTest مؤقتًا بالكامل، وذلك عن طريق تضمين ما يلي في ملف gradle.properties:

      android.testConfig.useRelativePath = true
    

المشاكل المعروفة

• عند استخدام الإصدار 1.3.31 أو إصدار أقدم من المكوّن الإضافي Kotlin Gradle، قد يظهر التحذير التالي عند إنشاء مشروعك أو مزامنته:

            WARNING: API 'variant.getPackageLibrary()' is obsolete and has been replaced
                    with 'variant.getPackageLibraryProvider()'.
            
          

  لحلّ هذه المشكلة، عليك ترقية المكوّن الإضافي إلى الإصدار 1.3.40 أو إصدار أحدث.

3.4.0 (نيسان/أبريل 2019)

يتطلّب هذا الإصدار من المكوّن الإضافي لنظام Android ما يلي:

• Gradle 5.1.1 أو إصدار أحدث لمزيد من المعلومات، يُرجى الاطّلاع على القسم المعنيّ بموضوع تحديث Gradle.

  ملاحظة: عند استخدام Gradle 5.0 والإصدارات الأحدث، يتم تقليل حجم ذاكرة وحدة تخزين Gradle الخفي التلقائي من 1 غيغابايت إلى 512 ميغابايت. وقد يؤدي ذلك إلى تراجع في أداء الإصدار. لتجاوز هذا الإعداد التلقائي، حدِّد حجم ذاكرة تخزين Gradle الرصدي في ملف gradle.properties الخاص بمشروعك.

• أدوات إنشاء حِزم SDK 28.0.3 أو إصدار أحدث

الميزات الجديدة

• إعدادات جديدة لفحص التبعية في أداة lint: تغيّر السلوك الخاص بـ lintChecks وتم تقديم lintPublish، وهو إعداد جديد للتعلّق، بهدف منح المستخدمين مزيدًا من التحكّم في عمليات تجميع عمليات فحص lint في مكتبات Android الخاصة بهم.

  • lintChecks: هذه ميزة حالية يجب استخدامها لفحوصات الأخطاء النحوية التي تريد تنفيذها فقط عند إنشاء مشروعك على الجهاز. إذا كنت تستخدم في السابق إعدادات تبعية lintChecks لتضمين عمليات فحص lint في حزمة AAR المنشورة، عليك نقل هذه التبعيات واستخدام إعدادات lintPublish الجديدة بدلاً من ذلك الموضّحة أدناه.
  • lintPublish: استخدِم هذا الإعداد الجديد في مشاريع مكتبة للتحقّق من الأخطاء النحوية التي تريد تضمينها في حزمة AAR المنشورة، كما هو موضّح أدناه. وهذا يعني أنّ المشروعات التي تستخدِم مكتبتك تطبِّق أيضًا عمليات التحقّق من الأخطاء النحوية هذه.

  يستخدم نموذج الرمز البرمجي التالي كلّ من إعدادات التبعيات في مشروع مكتبة Android محلي.

  dependencies {
    // Executes lint checks from the ':lint' project at build time.
    lintChecks project(':lint')
    // Packages lint checks from the ':lintpublish' in the published AAR.
    lintPublish project(':lintpublish')
  }
          

  dependencies {
    // Executes lint checks from the ':lint' project at build time.
    lintChecks(project(":lint"))
    // Packages lint checks from the ':lintpublish' in the published AAR.
    lintPublish(project(":lintpublish"))
      }
          

  • بوجه عام، من المفترض أن تلاحظ تحسينًا عامًا في سرعة إنشاء التطبيقات عند تنفيذ مهام الحزمة والتوقيع. إذا لاحظت تراجعًا في الأداء مرتبطًا بهذه المهام، يُرجى الإبلاغ عن خطأ.

تغييرات السلوك

• تحذير بشأن إيقاف المكوّن الإضافي لميزة "التطبيقات الفورية" من Android نهائيًا: إذا كنت لا تزال تستخدم المكوّن الإضافي com.android.feature لإنشاء تطبيقك الفوري، سيعرض لك المكوّن الإضافي 3.4.0 لنظام Gradle تحذيرًا بشأن إيقافه نهائيًا. للتأكّد من أنّه سيظل بإمكانك إنشاء تطبيقك الفوري على الإصدارات المستقبلية من المكوّن الإضافي، عليك نقل تطبيقك الفوري لاستخدام مكوّن الإضافي للميزات الديناميكية، الذي يتيح لك أيضًا نشر تجربتَي التطبيق المثبَّت والتطبيق الفوري من حِزمة تطبيق Android واحدة.

• R8 مفعَّل تلقائيًا: يدمج R8 إزالة الترميز المُبسّط، والتصغير، والتشويه، والتحسين، وإزالة الترميز، وكل ذلك في خطوة واحدة، ما يؤدي بدوره إلى تحسينات ملحوظة في أداء عملية الإنشاء. تم طرح R8 في الإصدار 3.3.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android، وهو مفعّل الآن تلقائيًا لكلٍّ من مشاريع التطبيقات ومكتبات Android باستخدام الإصدار 3.4.0 من المكوّن الإضافي والإصدارات الأحدث.

تقدّم الصورة أدناه نظرة عامة على مستوى عالٍ لعملية الترجمة قبل طرح الإصدار R8.

والآن، باستخدام R8، يتم تنفيذ عمليات إزالة الترميز السكري والتصغير والتشويه والتحسين وإزالة الترميز (D8) في خطوة واحدة، كما هو موضّح أدناه.

يُرجى العِلم أنّ أداة R8 مصمّمة للعمل مع قواعد ProGuard الحالية، لذلك من المرجّح ألا تحتاج إلى اتّخاذ أي إجراءات للاستفادة من أداة R8. ومع ذلك، بما أنّها تقنية مختلفة عن ProGuard المصمّمة خصيصًا لمشاريع Android، قد يؤدي التصغير والتحسين إلى إزالة رمز برمجي قد لا يزيلّه ProGuard. لذلك، في هذه الحالة غير المحتملة، قد تحتاج إلى إضافة قواعد إضافية للحفاظ على هذا الرمز في ناتج الإنشاء.

إذا واجهت مشاكل عند استخدام الإصدار R8، يُرجى قراءة الأسئلة الشائعة حول توافق الإصدار R8 للاطّلاع على ما إذا كان هناك حلّ لمشكلتك. إذا لم يتم توثيق حلّ، يُرجى الإبلاغ عن خطأ. يمكنك إيقاف R8 عن طريق إضافة أحد الأسطر التالية إلى ملف gradle.properties في مشروعك:

      # Disables R8 for Android Library modules only.
      android.enableR8.libraries = false
      # Disables R8 for all modules.
      android.enableR8 = false
      
    

ملاحظة: بالنسبة إلى نوع تصميم معيّن، إذا ضبطت قيمة useProguard على false في ملف build.gradle الخاص بوحدة تطبيقك، سيستخدم المكوِّن الإضافي لنظام Gradle المتوافق مع Android أداة R8 لتصغير رمز تطبيقك لهذا النوع من التصميم، بغض النظر عمّا إذا كان تم إيقاف أداة R8 في ملف gradle.properties الخاص بمشروعك.

• ndkCompile متوقّفة نهائيًا: ستظهر لك الآن رسالة خطأ في الإنشاء إذا حاولت استخدام ndkBuild لتجميع مكتباتك المجمّعة من رموز برمجية أصلية. يجب بدلاً من ذلك استخدام CMake أو ndk-build لإضافة رمز C وC++ إلى مشروعك.

المشاكل المعروفة

• لا يتم حاليًا فرض الاستخدام الصحيح لأسماء الحِزم الفريدة، ولكن سيتم فرض قواعد أكثر صرامة في الإصدارات اللاحقة من المكوّن الإضافي. في الإصدار 3.4.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android، يمكنك تفعيل ميزة التحقّق مما إذا كان مشروعك يعلن عن أسماء الحِزم المقبولة من خلال إضافة السطر أدناه إلىملف gradle.properties.

            android.uniquePackageNames = true
            
          

  لمعرفة مزيد من المعلومات عن ضبط اسم حزمة من خلال المكوّن الإضافي لنظام Gradle المتوافق مع Android، اطّلِع على ضبط رقم تعريف التطبيق.

3.3.0 (كانون الثاني/يناير 2019)

يتطلّب هذا الإصدار من المكوّن الإضافي لنظام Android ما يلي:

• Gradle 4.10.1 أو إصدار أحدث لمزيد من المعلومات، يُرجى الاطّلاع على القسم المتعلق بموضوع تحديث Gradle.

  ملاحظة: عند استخدام Gradle 5.0 والإصدارات الأحدث، ينخفض حجم ذاكرة heap التلقائي لبرنامج Gradle الخفي من 1 غيغابايت إلى 512 ميغابايت. قد يؤدي ذلك إلى تراجع في أداء الإصدار. لتجاوز هذا الإعداد التلقائي، حدِّد حجم ذاكرة تخزين Gradle المخفية في ملف gradle.properties الخاص بمشروعك.

• أدوات إنشاء حِزم SDK 28.0.3 أو إصدار أحدث

الميزات الجديدة

• مزامنة مسار البحث عن الرمز البرمجي المحسَّنة: عند حلّ التبعيات في مسارات البحث عن الرمز البرمجي في وقت التشغيل ووقت الترجمة، يحاول المكوّن الإضافي Gradle لنظام التشغيل Android حلّ بعض تعارضات الإصدارات في ما يتعلّق بالتبعيات التي تظهر في مسارات بحث عن الرمز البرمجي متعددة.

  على سبيل المثال، إذا كان مسار تجميع الرموز البرمجية يتضمّن الإصدار 2.0 من "المكتبة أ" وملف مسار تحميل الرموز البرمجية أثناء التشغيل يتضمّن الإصدار 1.0 من "المكتبة أ"، سيعدّل المكوّن الإضافي تلقائيًا التبعيات في ملف مسار تحميل الرموز البرمجية أثناء التشغيل إلى الإصدار 2.0 من "المكتبة أ" لتجنّب حدوث أخطاء.

  ومع ذلك، إذا كان مسار تجميع وقت التشغيل يتضمّن الإصدار 1.0 من "المكتبة أ" وملف compiling يتضمّن الإصدار 2.0 من "المكتبة أ"، لن يُنزِّل المكوّن الإضافي الإصدار المُستخدَم من ملف compiling classpath إلى الإصدار 1.0 من "المكتبة أ"، وسيظهر لك خطأ. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إصلاح التعارضات بين مسارات الفئات.

• تحسين عملية تجميع Java المتزايدة عند استخدام معالجات التعليقات التوضيحية: يقلل هذا التعديل من وقت الإنشاء من خلال تحسين التوافق مع عملية تجميع Java المتزايدة عند استخدام معالجات التعليقات التوضيحية.

  ملاحظة: تتوافق هذه الميزة مع الإصدار 4.10.1 من Gradle والإصدارات الأحدث، باستثناء الإصدار 5.1 من Gradle بسبب مشكلة Gradle 8194.

  • بالنسبة إلى المشاريع التي تستخدم Kapt (معظم المشاريع التي تستخدم Kotlin فقط والمشاريع الهجينة التي تستخدم Kotlin وJava): يكون ميزة التجميع المتزايد لـ Java مفعَّلة، حتى عند استخدام ربط البيانات أو المكوّن الإضافي retro-lambda. لا تتم معالجة التعليقات التوضيحية من خلال مهمة Kapt بشكل متزايد بعد.

  • بالنسبة إلى المشاريع التي لا تستخدم Kapt (المشاريع المستندة إلى Java فقط): إذا كانت جميع معالجات التعليقات التوضيحية التي تستخدمها توفّر معالجة التعليقات التوضيحية المتزايدة، يتم تفعيل المعالجة المتزايدة لـ Java تلقائيًا. لمراقبة استخدام معالج التعليقات التوضيحية بشكل متزايد، راقِب مشكلة Gradle 5277.

    ومع ذلك، إذا كان هناك معالج واحد أو أكثر للتعليقات التوضيحية لا يتيح عمليات الإنشاء المتزايدة، لن يتم تفعيل عملية الترجمة المبرمَجة المتزايدة لـ Java. بدلاً من ذلك، يمكنك تضمين العلامة التالية في ملف gradle.properties:

    android.enableSeparateAnnotationProcessing=true
                

    عند تضمين هذا الإعداد، ينفِّذ المكوِّن الإضافي لـ Android Gradle معالجات التعليقات التوضيحية في مهمة منفصلة ويسمح بتنفيذ مهمة ترجمة Java بشكل تدريجي.

• معلومات أفضل لتصحيح الأخطاء عند استخدام واجهة برمجة تطبيقات قديمة: عندما يرصد المكوّن الإضافي أنّك تستخدم واجهة برمجة تطبيقات لم تعُد متوافقة، يمكنه الآن تقديم معلومات أكثر تفصيلاً لمساعدتك في تحديد مكان استخدام واجهة برمجة التطبيقات هذه. للاطّلاع على المعلومات الإضافية، عليك تضمين ما يلي فيملف gradle.properties الخاص بمشروعك:

            android.debug.obsoleteApi=true
          

  يمكنك أيضًا تفعيل العلامة من خلال إدخال -Pandroid.debug.obsoleteApi=true من سطر الأوامر.

• يمكنك إجراء اختبارات الأدوات على وحدات الميزات من سطر الأوامر.

تغييرات السلوك

• ضبط المهام بشكلٍ غير فوري: يستخدم المكوّن الإضافي الآن واجهة برمجة التطبيقات الجديدة لإنشاء المهام في Gradle لتجنُّب بدء المهام وضبطها إذا لم تكن مطلوبة لإكمال عملية الإنشاء الحالية (أو المهام غير المضمّنة في الرسم البياني لمهام التنفيذ). على سبيل المثال، إذا كان لديك عدة أنواع من الإصدارات، مثل "الإصدار العلني" و"إصدار تصحيح الأخطاء"، وكنت بصدد إنشاء إصدار "تصحيح الأخطاء" من تطبيقك، سيتجنّب المكوّن الإضافي بدء المهام وضبطها للإصدار "العلني" من تطبيقك.

  قد يؤدي استدعاء طرق قديمة معيّنة في Variants API، مثل variant.getJavaCompile()، إلى فرض ضبط المهام. للتأكّد من أنّ الإصدار محسّن لإعداد المهام غير المُشغَّلة، استخدِم طُرقًا جديدة تُعرِض بدلاً من ذلك عنصرًا TaskProvider ، مثل variant.getJavaCompileProvider().

  إذا كنت تنفِّذ مهام إنشاء مخصّصة، تعرَّف على كيفية التكيّف مع واجهة برمجة التطبيقات الجديدة لإنشاء المهام في Gradle.

• بالنسبة إلى نوع إصدار معيّن، عند ضبط useProguard false، يستخدم المكوّن الإضافي الآن أداة R8 بدلاً من ProGuard لتصغير رمز تطبيقك وموارده وإخفاءها. لمزيد من المعلومات حول R8، يمكنك قراءة مشاركة المدونة هذه من مدوّنة مطوّري تطبيقات Android.

• إنشاء فئة R بشكل أسرع لمشاريع المكتبات: في السابق، كان المكوّن الإضافي لنظام Gradle المتوافق مع Android ينشئ ملفًا R.java لكل ملف من ملفات الاعتماد في مشروعك، ثم يجمع فئات R هذه مع فئات تطبيقك الأخرى. ينشئ المكوّن الإضافي الآن ملف JAR يحتوي على فئة R المُجمَّعة لتطبيقك مباشرةً، بدون إنشاء فئات R.java وسيطة أولاً. قد يؤدي هذا التحسين إلى تحسين أداء الإنشاء بشكل كبير للمشاريع التي تتضمن العديد من المشاريع الفرعية للمكتبة والتبعيات، وتحسين سرعة الفهرسة في Android Studio.

• عند إنشاء مجموعة حزمات تطبيق Android، تتضمّن حِزم APK التي يتم إنشاؤها من حِزمة التطبيق التي تستهدف الإصدار 6.0 من نظام التشغيل Android (المستوى 23 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث الآن إصدارات غير مضغوطة من مكتباتك المجمّعة من رموز برمجية أصلية تلقائيًا. يتجنّب هذا التحسين الحاجة إلى أن يُنشئ الجهاز نسخة من المكتبة، وبالتالي يقلل حجم تطبيقك على القرص. إذا كنت تفضّل إيقاف هذا التحسين، أضِف ما يلي إلى ملف gradle.properties:

  android.bundle.enableUncompressedNativeLibs = false
          

• تفرض المكوّنة الإضافية الحدّ الأدنى من إصدارات بعض المكوّنات الإضافية التابعة لجهات خارجية.

• مزامنة مشروع يتضمّن إصدارًا واحدًا: تُعدّ مزامنة مشروعك مع إعدادات الإصدار خطوة مهمة للسماح لخدمة "استوديو Android" بفهم بنية مشروعك. ومع ذلك، يمكن أن تكون هذه العملية تستغرق وقتًا طويلاً في حال كانت المشاريع كبيرة. إذا كان مشروعك يستخدم عدة خيارات للإصدار، يمكنك الآن تحسين عمليات مزامنة المشروع من خلال حصرها بالخيار الذي اخترته حاليًا فقط.

  يجب استخدام الإصدار 3.3 من Android Studio أو إصدار أحدث مع الإصدار 3.3.0 من "مكوّن Android Gradle الإضافي" لتفعيل هذا التحسين. عند استيفاء هذه المتطلبات، يطلب منك IDE تفعيل هذا التحسين عند مزامنة مشروعك. يتم أيضًا تفعيل ميزة التحسين تلقائيًا في المشاريع الجديدة.

  لتفعيل هذا التحسين يدويًا، انقر على ملف > الإعدادات > ميزات تجريبية > Gradle (Android Studio > الإعدادات المفضّلة > ميزات تجريبية > Gradle على جهاز Mac) وضَع علامة في مربّع الاختيار مزامنة الصيغة النشطة فقط.

  ملاحظة: يتوافق هذا التحسين تمامًا مع المشاريع التي تشمل لغتَي Java وC++، ويتوافق جزئيًا مع Kotlin. عند تفعيل التحسين للمشاريع التي تحتوي على محتوى Kotlin، يعود Gradle sync إلى استخدام الصيغ الكاملة داخليًا.

• التنزيل التلقائي لحِزم SDK غير المتوفّرة: تم توسيع نطاق هذه الوظيفة لتتوافق مع حزمة NDK. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تنزيل الحِزم المفقودة تلقائيًا باستخدام Gradle.

إصلاح الأخطاء

• يعالج الإصدار 3.3.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android المشاكل التالية:

  • عملية الإنشاء تستدعي android.support.v8.renderscript.RenderScript بدلاً من إصدار AndroidX، على الرغم من تفعيل Jetifier
  • تعارضات بسبب androidx-rs.jar، بما في ذلك الحِزم المجمّعة بشكل ثابت annotation.AnyRes
  • عند استخدام RenderScript، لم يعُد عليك ضبط إصدار "أدوات الإنشاء" يدويًا في ملفات build.gradle.

3.2.0 (أيلول/سبتمبر 2018)

يتطلّب هذا الإصدار من المكوّن الإضافي لنظام Android ما يلي:

• ‫Gradle 4.6 أو إصدار أحدث لمزيد من المعلومات، يُرجى الاطّلاع على القسم المعنيّ بتحديث Gradle.
• أدوات إنشاء حِزم SDK 28.0.3 أو إصدار أحدث

الميزات الجديدة

• إتاحة إنشاء حِزم تطبيقات Android: حِزمة التطبيق هي تنسيق تحميل جديد يتضمّن جميع الرموز البرمجية المجمّعة ومواد العرض في تطبيقك، مع تأجيل إنشاء حِزم APK وتوقيعها إلى "متجر Google Play". لم يعُد عليك إنشاء حِزم APK متعددة وتوقيعها وإدارتها، ويحصل المستخدمون على عمليات تنزيل أصغر حجمًا محسَّنة لأجهزةهم. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة لمحة عن حِزم تطبيق Android.

• إتاحة سرعات محسّنة لعملية الإنشاء المتزايد عند استخدام معالجات التعليقات التوضيحية: تم توسيع نطاق CommandLineArgumentProvider الآن باستخدام AnnotationProcessorOptions DSL، ما يتيح لك أو لمؤلف معالج التعليقات التوضيحية إضافة تعليقات توضيحية إلى مَعلمات المعالج باستخدام تعليقات توضيحية لأنواع المواقع التي يتم إنشاؤها بشكل متزايد. يؤدي استخدام هذه التعليقات التوضيحية إلى تحسين صحة وأداء عمليات الإنشاء النظيفة المتزايدة والمخزّنة مؤقتًا. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تمرير الوسيطات إلى معالجات التعليقات التوضيحية.

• أداة نقل البيانات إلى AndroidX: عند استخدام الإصدار 3.2.0 من المكوّن الإضافي Android Gradle مع الإصدار 3.2 من Android والإصدارات الأحدث، يمكنك نقل ملفاتك المرجعية المحلية وMaven لمشروعك لاستخدام مكتبات AndroidX الجديدة من خلال اختيار إعادة صياغة > نقل البيانات إلى AndroidX من شريط القوائم. يؤدي استخدام أداة نقل البيانات هذه أيضًا إلى ضبط العلامات التالية على true في ملف gradle.properties:

  • ‫android.useAndroidX: عند ضبطه على true، يستخدم المكوّن الإضافي لنظام التشغيل Android مكتبة AndroidX المناسبة بدلاً من مكتبة Support Library. في حال عدم تحديد هذه العلامة ، يضبط المكوّن الإضافي القيمة على false تلقائيًا.

  • ‫android.enableJetifier: عند ضبط القيمة على true، يؤدي المكوّن الإضافي لنظام التشغيل Android إلى نقل المكتبات الحالية التابعة لجهات خارجية تلقائيًا لاستخدام AndroidX من خلال إعادة كتابة ملفاتها الثنائية. في حال عدم تحديد هذه العلامة، يضبط المكوّن الإضافي القيمة false تلقائيًا. يمكنك ضبط هذه العلامة على true فقط عندما يكون android.useAndroidX مضبوطًا أيضًا على true، وإلا سيظهر لك خطأ في عملية الإنشاء.

    لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على AndroidX.

• أداة جديدة لتصغير حجم الرموز البرمجية، وهي R8: R8 هي أداة جديدة لتصغير حجم الرموز البرمجية وتشفيرها وتحلّ محلّ ProGuard. يمكنك بدء استخدام الإصدار التجريبي من R8 من خلال تضمين ما يلي في ملف gradle.properties الخاص بمشروعك:

          android.enableR8 = true
          

          android.enableR8 = true
          

تغييرات السلوك

• تم تفعيل إزالة السكر باستخدام D8 تلقائيًا.

• يتوفّر AAPT2 الآن في مستودع Maven من Google. لاستخدام AAPT2، تأكَّد من أنّ ملف build.gradle يحتوي على التبعية google()، كما هو موضّح أدناه:

            buildscript {
                  repositories {
                      google() // here
                      jcenter()
                  }
                  dependencies {
                      classpath 'com.android.tools.build:gradle:3.2.0'
                  }
              }
              allprojects {
                  repositories {
                      google() // and here
                      jcenter()
              }
            

            buildscript {
                  repositories {
                      google() // here
                      jcenter()
                  }
                  dependencies {
                      classpath 'com.android.tools.build:gradle:3.2.0'
                  }
              }
              allprojects {
                  repositories {
                      google() // and here
                      jcenter()
              }
            

• أصبح حِزم MultiDex الأصلية مفعَّلة تلقائيًا. كانت الإصدارات السابقة من Android Studio تتيح استخدام حزمة multidex الأصلية عند نشر إصدار تصحيح الأخطاء من التطبيق على جهاز يعمل بالإصدار 21 من واجهة برمجة التطبيقات لنظام التشغيل Android أو إصدار أحدث. الآن، سواء كنت بصدد نشر التطبيق على جهاز أو إنشاء حزمة APK لإصدارها، يعمل المكوّن الإضافي لـ Android Gradle على تفعيل ميزة "الملفّات المتعددة للغة البرمجة الأصلية" لجميع الوحدات التي تم ضبط minSdkVersion=21 أو إصدار أحدث لها.

• يفرض المكوّن الإضافي الآن الحد الأدنى لإصدار المكوّن الإضافي protobuf (0.8.6) والكوكاتل (1.2.50) ومكوّن Crashlytics الإضافي (1.25.4).

• يفرض المكوّن الإضافي لوحدة الميزاتcom.android.feature الآن استخدام الأحرف والأرقام والشرطات السفلية فقط عند تحديد اسم الوحدة. على سبيل المثال، إذا كان اسم وحدة الميزات يتضمّن شرطات، سيظهر لك خطأ في الإنشاء. يتطابق هذا السلوك مع سلوك مكوّن ميزة الديناميكية الإضافي.

إصلاح الأخطاء

• يمكن الآن تخزين JavaCompile مؤقتًا في المشاريع التي تتضمّن ربط البيانات. (المشكلة رقم 69243050)
• تجنُّب أفضل للترجمة في وحدات المكتبة التي تستخدم ربط البيانات (المشكلة رقم 77539932)
• يمكنك الآن إعادة تفعيل ميزة الضبط عند الطلب إذا كنت قد أوقفتها في الإصدارات السابقة بسبب بعض أخطاء الإنشاء غير المتوقّعة. (المشكلة رقم 77910727)

3.1.0 (آذار/مارس 2018)

يتطلّب هذا الإصدار من المكوّن الإضافي لنظام Android ما يلي:

• ‫Gradle 4.4 أو إصدار أحدث

  لمزيد من المعلومات، يُرجى الاطّلاع على القسم المعنيّ بموضوع تحديث Gradle.

• أدوات الإنشاء 27.0.3 أو إصدار أحدث

  يُرجى العِلم أنّه لم يعُد عليك تحديد إصدار لأدوات الإنشاء باستخدام السمة android.buildToolsVersion، إذ يستخدم المكوّن الملحق الحد الأدنى للإصدار المطلوب تلقائيًا.

أداة تحويل DEX جديدة، D8

يستخدم "استوديو Android" الآن بشكل تلقائي مُجمِّع DEX جديدًا يُسمى D8. تجميع ملف DEX هو عملية تحويل رمز برمجي .class إلى رمز برمجي .dex لاستخدامه في "وقت تشغيل Android" (أو Dalvik للإصدارات القديمة من Android). مقارنةً بالمجمِّع السابق المُسمى DX، يُجمِّع D8 العملية بشكل أسرع ويُخرج ملفات DEX أصغر حجمًا، مع الحفاظ على الأداء نفسه أو أفضل في وقت تشغيل التطبيق.

من المفترض ألا يؤدي استخدام D8 إلى تغيير سير عمل تطوير التطبيقات اليومي. ومع ذلك، إذا كنت تواجه أي مشاكل متعلقة بالمجمِّع الجديد، يُرجى الإبلاغ عن خطأ. يمكنك مؤقتًا إيقاف D8 واستخدام DX من خلال تضمين ما يلي فيملف gradle.properties الخاص بمشروعك:

      android.enableD8=false
    

بالنسبة إلى المشاريع التي تستخدم ميزات لغة Java 8، يتم تفعيل ميزة إزالة الترميز بشكل تدريجي تلقائيًا. يمكنك إيقافه من خلال تحديد ما يلي في ملف gradle.properties الخاص بمشروعك:

      android.enableIncrementalDesugaring=false.
    

مستخدمو الإصدارات التجريبية: إذا كنت تستخدم حاليًا إصدارًا تجريبيًا من D8، يُرجى العِلم أنّه يتم الآن تجميعه باستخدام المكتبات المضمّنة في أدوات إنشاء حِزم SDK، وليس JDK. وبالتالي، إذا كنت تصل إلى واجهات برمجة التطبيقات المتوفّرة في حزمة JDK ولكن ليس في مكتبات أدوات إنشاء حزمة SDK، ستظهر لك رسالة خطأ في الترجمة.

تغييرات السلوك

• عند إنشاء حِزم APK متعددة تستهدف كلّ منها واجهة تطبيقات ثنائية مختلفة، لن يُنشئ ملف حِزم APK لواجهات ABI التالية تلقائيًا: mips وmips64 وarmeabi.

  إذا كنت تريد إنشاء حِزم APK تستهدف معرّفات ABI هذه، عليك استخدام NDK r16b أو إصدار أقدم و تحديد معرّفات ABI في ملف build.gradle، كما هو موضّح أدناه:

            splits {
                abi {
                    include 'armeabi', 'mips', 'mips64'
                    ...
                }
            }
          

            splits {
                abi {
                    include("armeabi", "mips", "mips64")
                    ...
                }
            }
          

• تُزيل الآن الذاكرة المخبأة للإنشاء في المكوّن الإضافي لنظام التشغيل Android إدخالات الذاكرة المخبأة التي مرّ عليها أكثر من 30 يومًا.

• عند تمرير "auto" إلى resConfig لم يعُد يتم تلقائيًا اختيار موارد السلاسل لحزمها في حزمة APK. في حال مواصلة استخدام "auto"، يحزم المكوّن الإضافي جميع موارد السلاسل التي يوفّرها تطبيقك وتبعياته. لذلك، عليك بدلاً من ذلك تحديد كل لغة تريد أن ينشئ المكوّن الإضافي حِزمة لها في حزمة APK.

• بما أنّ الوحدات المحلية لا يمكنها الاعتماد على حزمة APK الاختبارية لتطبيقك، فإنّ إضافة متطلّبات إلى اختباراتك المستندة إلى أدوات القياس باستخدام إعداد androidTestApi بدلاً من androidTestImplementation يؤدي إلى إصدار Gradle للانذار التالي:

          WARNING: Configuration 'androidTestApi' is obsolete
          and has been replaced with 'androidTestImplementation'
          

          WARNING: Configuration 'androidTestApi' is obsolete
          and has been replaced with 'androidTestImplementation'
          

الإصلاحات

• إصلاح مشكلة عدم تعرّف Android Studio بشكلٍ صحيح على التبعيات في عمليات الإنشاء المركبة
• إصلاح مشكلة ظهور خطأ في مزامنة المشروع عند تحميل المكوّن الإضافي لنظام التشغيل Android عدة مرات في عملية إنشاء واحدة، على سبيل المثال، عندما يتضمّن كل من المشاريع الفرعية المتعدّدة المكوّن الإضافي لنظام التشغيل Android في classpath لنص الترميز البرمجي للمشروع

3.0.0 (تشرين الأول/أكتوبر 2017)

يتضمّن الإصدار 3.0.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android مجموعة متنوعة من التغييرات التي تهدف إلى حلّ مشاكل الأداء في المشاريع الكبيرة.

على سبيل المثال، في نموذج لمشروع هيكل أساسييتضمّن 130 وحدة تقريبًا وعددًا كبيرًا من التبعيات الخارجية (ولكن بدون رمز أو موارد)، يمكنك ملاحظة تحسينات في الأداء مثل ما يلي:

تؤدي بعض هذه التغييرات إلى إيقاف الإصدارات الحالية. لذلك، عليك مراعاة\ الجهد المبذول لنقل مشروعك قبل استخدام المكوّن الإضافي الجديد.

إذا لم تلاحظ تحسينات الأداء الموضّحة أعلاه، يُرجى إبلاغنا بخطأ وتضمين سجلّ لإصدارك باستخدام Gradle Profiler.

يتطلّب هذا الإصدار من المكوّن الإضافي لنظام Android ما يلي:

• ‫Gradle 4.1 أو إصدار أحدث لمزيد من المعلومات، يُرجى الاطّلاع على القسم المعنيّ بتحديث Gradle.
• أدوات الإنشاء 26.0.2 أو إصدار أحدث من خلال هذا التعديل، لن تحتاج إلى تحديد إصدار لأدوات الإنشاء، إذ يستخدم المكوّن الإضافي الحد الأدنى من الإصدار المطلوب تلقائيًا. وبالتالي، يمكنك الآن إزالة الموقع android.buildToolsVersion.

التحسينات

• توفُّر توازٍ أفضل للمشاريع المتعدّدة الوحدات من خلال رسم بياني مفصّل للمهام
• عند إجراء تغييرات على التبعية، يُجري Gradle عمليات إنشاء أسرع من خلال عدم إعادة تجميع الوحدات التي لا يمكنها الوصول إلى واجهة برمجة التطبيقات الخاصة بهذه التبعية. يجب حظر التبعيات التي تسرِّب واجهات برمجة التطبيقات إلى الوحدات الأخرى من خلال استخدام إعدادات التبعيات الجديدة في Gradle: implementation وapi وcompileOnly وruntimeOnly.
• سرعة إنشاء متزايدة بشكل أسرع بسبب الفهرسة لكل فئة يتم الآن compiling كل فئة في ملفات DEX منفصلة، ولا تتم إعادة إنشاء فهرس للفئات التي تم تعديلها فقط. من المفترض أيضًا أن تلاحظ سرعات إنشاء محسّنة ل التطبيقات التي تضبط minSdkVersion على 20 أو أقل، وتستخدم حِزم dex المتعددة القديمة.
• سرعات إنشاء محسّنة من خلال تحسين مهام معيّنة لاستخدام النتائج المخزّنة للاستفادة من هذا التحسين، عليك أولاً تفعيل ذاكرة التخزين المؤقت لإنشاء Gradle.
• معالجة أفضل للموارد المتزايدة باستخدام AAPT2، وهو الآن فعال تلقائيًا إذا كنت تواجه مشاكل أثناء استخدام AAPT2، يُرجى الإبلاغ عن خطأ. يمكنك أيضًا إيقاف AAPT2 من خلال ضبط android.enableAapt2=false فيملف gradle.properties وإعادة تشغيل برنامج Gradle الخفي من خلال تشغيل ./gradlew --stop من سطر الأوامر.

الميزات الجديدة

• إدارة تبعية تراعي خيارات المنتج عند إنشاء إصدار معيّن من إحدى الوحدات، يطابق المكوّن الإضافي الآن تلقائيًا إصدارات الوحدات المحلية التي تعتمد على الإصدار من الوحدة التي يتم إنشاؤها.
• يتضمّن المكوّن الإضافي الجديد لوحدة الميزات تطبيقات Android الفورية وحزمة تطوير البرامج (SDK) لتطبيقات Android الفورية (التي يمكنك تنزيلها باستخدام أداة إدارة حِزم SDK). للاطّلاع على مزيد من المعلومات عن إنشاء وحدات ميزات باستخدام المكوّن الإضافي الجديد، يمكنك قراءة مقالة بنية تطبيق فوري يتضمّن ميزات متعدّدة.
• إتاحة استخدام ميزات لغة Java 8 ومكتبات Java 8 معيّنة بشكل مضمّن تم إيقاف Jack نهائيًا ولم يعُد مطلوبًا، ويجب أولاً إيقاف Jack لاستخدام أدوات Java 8 المحسّنة المضمّنة في مجموعة الأدوات التلقائية. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة استخدام ميزات لغة Java 8.

• تمت إضافة ميزة إتاحة إجراء الاختبارات باستخدام منصّة تنسيق اختبارات Android، ما يتيح لك إجراء كل اختبارات تطبيقك ضمن طلب أداة Instrumentation الخاص به. بما أنّ كل اختبار يتم تشغيله في مثيل أدوات القياس الخاص به، لا تتراكم أي حالة مشترَكة بين الاختبارات في وحدة المعالجة المركزية أو الذاكرة على جهازك. وحتى إذا تعطّل اختبار واحد، لن يؤدي ذلك إلا إلى إيقاف نسخة أداة Instrumentation الخاصة به، ما يضمن استمرار تنفيذ اختباراتك الأخرى.

  • تمت إضافة testOptions.execution لتحديد ما إذا كان سيتم استخدام عملية تنسيق الاختبار على الجهاز. إذا كنت تريد استخدام أداة "تنسيق اختبارات Android"، عليك تحديد ANDROID_TEST_ORCHESTRATOR، كما هو موضّح أدناه. يتم ضبط هذه السمة تلقائيًا على HOST، ما يؤدي إلى إيقاف عملية التنسيق على الجهاز، وهي الطريقة العادية لإجراء الاختبارات.

  رائع

          android {
            testOptions {
              execution 'ANDROID_TEST_ORCHESTRATOR'
            }
          }
          

  Kotlin

          android {
            testOptions {
              execution = "ANDROID_TEST_ORCHESTRATOR"
            }
          }
          

• تتيح لك إعدادات الاعتماد الجديدة على androidTestUtil تثبيت حزمة APK أخرى لمساعدة الاختبار قبل تشغيل اختبارات أداة القياس، مثل أداة "تنسيق اختبارات Android":

  رائع

          dependencies {
            androidTestUtil 'com.android.support.test:orchestrator:1.0.0'
            ...
          }
          

  Kotlin

          dependencies {
            androidTestUtil("com.android.support.test:orchestrator:1.0.0")
            ...
          }
          

• تمت إضافة testOptions.unitTests.includeAndroidResources لتوفير إمكانية إجراء اختبارات الوحدة التي تتطلّب موارد Android، مثل Roboelectric. عند ضبط هذه السمة على true، يُجري المكوّن الإضافي عملية دمج للموارد ومواد العرض والملفات البيانية قبل تشغيل اختبارات الوحدات. يمكن لاختباراتك بعد ذلك التحقّق من com/android/tools/test_config.properties فيملف com/android/tools/test_config.properties classpath للمفاتيح التالية:

  • android_merged_assets: المسار المطلق إلى دليل مواد العرض المدمجة

    ملاحظة: بالنسبة إلى وحدات المكتبة، لا تحتوي مواد العرض المدمجة على مواد عرض الملحقات (راجِع المشكلة رقم 65550419).

  • ‫android_merged_manifest: المسار المطلق إلىملف البيان المدمج

  • ‫android_merged_resources: المسار المطلق إلى دليل الموارد المدمجة، الذي يحتوي على جميع الموارد من الوحدة وجميع العناصر التي تعتمد عليها.

  • ‫android_custom_package: اسم حزمة فئة R النهائية في حال تعديل رقم تعريف التطبيق ديناميكيًا، قد لا يتطابق اسم الحزمة package مع سمة package في ملف بيان تطبيقك.

• إتاحة استخدام الخطوط كموارد (وهي ميزة جديدة تم تقديمها في Android 8.0 (المستوى 26 لواجهة برمجة التطبيقات))
• إتاحة ملفات APK المخصّصة للغة مع حزمة تطوير البرامج (SDK) 1.1 لتطبيقات Android الفورية والإصدارات الأحدث

• يمكنك الآن تغيير دليل الإخراج لمشروع الإصدار المتوافق مع الأجهزة المتوفّرة خارج المتجر الخارجي، كما هو موضّح أدناه:

  رائع

          android {
              ...
              externalNativeBuild {
                  // For ndk-build, instead use the ndkBuild block.
                  cmake {
                      ...
                      // Specifies a relative path for outputs from external native
                      // builds. You can specify any path that's not a subdirectory
                      // of your project's temporary build/ directory.
                      buildStagingDirectory "./outputs/cmake"
                  }
              }
          }
          

  Kotlin

          android {
              ...
              externalNativeBuild {
                  // For ndk-build, instead use the ndkBuild block.
                  cmake {
                      ...
                      // Specifies a relative path for outputs from external native
                      // builds. You can specify any path that's not a subdirectory
                      // of your project's temporary build/ directory.
                      buildStagingDirectory = "./outputs/cmake"
                  }
              }
          }
          

• يمكنك الآن استخدام CMake 3.7 أو إصدار أحدث عند إنشاء مشاريع أصلية من Android Studio.

• تتيح لك إعدادات التبعيات الجديدة في lintChecks إنشاء حزمة JAR تحدّد قواعد lint مخصّصة، وتُحزِّمها في مشاريع AAR وAPK.

  يجب أن تنتمي قواعد lint المخصّصة إلى مشروع منفصل يُنشئملف JAR واحدًا ويتضمّن فقط تبعيات compileOnly. يمكن بعد ذلك أن تعتمد وحدات التطبيقات والمكتبات الأخرى على مشروع lint باستخدام إعدادات lintChecks:

  رائع

          dependencies {
              // This tells the Gradle plugin to build ':lint-checks' into a lint.jar file
              // and package it with your module. If the module is an Android library,
              // other projects that depend on it automatically use the lint checks.
              // If the module is an app, lint includes these rules when analyzing the app.
              lintChecks project(':lint-checks')
          }
          

  Kotlin

          dependencies {
              // This tells the Gradle plugin to build ':lint-checks' into a lint.jar file
              // and package it with your module. If the module is an Android library,
              // other projects that depend on it automatically use the lint checks.
              // If the module is an app, lint includes these rules when analyzing the app.
              lintChecks(project(":lint-checks"))
          }
          

تغييرات السلوك

• يزيل المكوّن الإضافي لنظام Android 3.0.0 واجهات برمجة تطبيقات معيّنة، وسيتم إيقاف عملية التصميم إذا كنت تستخدمها. على سبيل المثال، لم يعُد بإمكانك استخدام Variants API لمحاولة الوصول إلى عناصر outputFile() أو استخدام processManifest.manifestOutputFile() للحصول على ملف البيان لكلّ صيغة. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في واجهة برمجة التطبيقات.
• لم تعُد بحاجة إلى تحديد إصدار لأدوات الإنشاء (وبذلك، يمكنك الآن إزالة سمة android.buildToolsVersion). بشكلٍ تلقائي، يستخدم المكوّن الإضافي الحد الأدنى من إصدار أدوات الإنشاء المطلوب لإصدار المكوّن الإضافي لنظام التشغيل Android الذي تستخدمه.
• يمكنك الآن تفعيل ميزة "ضغط ملفات PNG" أو إيقافها في القسم buildTypes كما هو موضّح أدناه. يتم تفعيل ميزة تقليل حجم ملفات PNG تلقائيًا لجميع عمليات الإنشاء باستثناء عمليات إنشاء تصحيح الأخطاء لأنّها تزيد من أوقات إنشاء المشاريع التي تتضمّن العديد من ملفات PNG. لذلك، لتحسين أوقات إنشاء أنواع الإصدارات الأخرى، عليك إيقاف ميزة تقليل حجم ملفات PNG أو تحويل صورك إلى WebP.

  رائع

        android {
          buildTypes {
            release {
              // Disables PNG crunching for the release build type.
              crunchPngs false
            }
          }
        }
        

  Kotlin

        android {
          buildTypes {
            release {
              // Disables PNG crunching for the release build type.
              isCrunchPngs = false
            }
          }
        }
        

• ينشئ المكوّن الإضافي لنظام التشغيل Android الآن تلقائيًا استهدافات قابلة للتنفيذ يمكنك ضبطها في مشاريع CMake الخارجية.
• عليك الآن إضافة معالجات التعليقات التوضيحية إلى مسار تحميل المعالج باستخدام إعدادات التبعيات annotationProcessor.
• أصبح استخدام ndkCompile المتوقّف نهائيًا أكثر تقييدًا الآن. بدلاً من ذلك، عليك نقل البيانات لاستخدام CMake أو ndk-build لتجميع الرمز الأصلي الذي تريد حزمه في حزمة APK. لمعرفة المزيد من المعلومات، يُرجى الاطّلاع على مقالة نقل البيانات من ndkcompile.

3.0.0 (تشرين الأول/أكتوبر 2017)

يتضمّن الإصدار 3.0.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android مجموعة متنوعة من التغييرات التي تهدف إلى حلّ مشاكل الأداء في المشاريع الكبيرة.

على سبيل المثال، في نموذج لمشروع هيكل أساسييتضمّن 130 وحدة تقريبًا وعددًا كبيرًا من التبعيات الخارجية (ولكن بدون رمز أو موارد)، يمكنك ملاحظة تحسينات في الأداء مثل ما يلي:

تؤدي بعض هذه التغييرات إلى إيقاف الإصدارات الحالية. لذلك، عليك مراعاة\ الجهد المبذول لنقل مشروعك قبل استخدام المكوّن الإضافي الجديد.

إذا لم تلاحظ تحسينات الأداء الموضّحة أعلاه، يُرجى إبلاغنا بخطأ وتضمين سجلّ لإصدارك باستخدام Gradle Profiler.

يتطلّب هذا الإصدار من المكوّن الإضافي لنظام Android ما يلي:

• ‫Gradle 4.1 أو إصدار أحدث لمزيد من المعلومات، يُرجى الاطّلاع على القسم المعنيّ بموضوع تحديث Gradle.
• أدوات الإنشاء 26.0.2 أو إصدار أحدث من خلال هذا التعديل، لن تحتاج إلى تحديد إصدار لأدوات الإنشاء، إذ يستخدم المكوّن الإضافي الحد الأدنى من الإصدار المطلوب تلقائيًا. وبالتالي، يمكنك الآن إزالة الموقع android.buildToolsVersion.

التحسينات

• توفُّر توازٍ أفضل للمشاريع المتعدّدة الوحدات من خلال رسم بياني مفصّل للمهام
• عند إجراء تغييرات على التبعية، يُجري Gradle عمليات إنشاء أسرع من خلال عدم إعادة تجميع الوحدات التي لا يمكنها الوصول إلى واجهة برمجة التطبيقات الخاصة بهذه التبعية. يجب حظر التبعيات التي تسرِّب واجهات برمجة التطبيقات إلى الوحدات الأخرى من خلال استخدام إعدادات التبعيات الجديدة في Gradle: implementation وapi وcompileOnly وruntimeOnly.
• سرعة إنشاء متزايدة بشكل أسرع بسبب الفهرسة لكل فئة يتم الآن compiling كل فئة في ملفات DEX منفصلة، ولا تتم إعادة إنشاء ملف DEX إلا للفئات التي تم تعديلها. من المفترض أيضًا أن تلاحظ سرعات إنشاء محسّنة ل التطبيقات التي تضبط minSdkVersion على 20 أو أقل، وتستخدم حِزم dex متعددة لإصدارات Android القديمة.
• سرعات إنشاء محسّنة من خلال تحسين مهام معيّنة لاستخدام النتائج المخزّنة للاستفادة من هذا التحسين، عليك أولاً تفعيل ذاكرة التخزين المؤقت لإنشاء Gradle.
• معالجة أفضل للموارد المتزايدة باستخدام AAPT2، وهو الآن فعال تلقائيًا إذا كنت تواجه مشاكل أثناء استخدام AAPT2، يُرجى الإبلاغ عن خطأ. يمكنك أيضًا إيقاف AAPT2 من خلال ضبط android.enableAapt2=false فيملف gradle.properties وإعادة تشغيل برنامج Gradle الخفي من خلال تشغيل ./gradlew --stop من سطر الأوامر.

الميزات الجديدة

• إدارة تبعية تراعي خيارات المنتج عند إنشاء إصدار معيّن من إحدى الوحدات، يطابق المكوّن الإضافي الآن تلقائيًا إصدارات الوحدات المحلية التي تعتمد على الإصدار من الوحدة التي يتم إنشاؤها.
• يتضمّن المكوّن الإضافي الجديد لوحدة الميزات تطبيقات Android الفورية وحزمة تطوير البرامج (SDK) لتطبيقات Android الفورية (التي يمكنك تنزيلها باستخدام أداة إدارة حِزم SDK). للاطّلاع على مزيد من المعلومات عن إنشاء وحدات ميزات باستخدام المكوّن الإضافي الجديد، يمكنك قراءة مقالة بنية تطبيق فوري يتضمّن ميزات متعدّدة.
• إتاحة استخدام ميزات لغة Java 8 ومكتبات Java 8 معيّنة بشكل مضمّن تم إيقاف Jack نهائيًا ولم يعُد مطلوبًا، ويجب أولاً إيقاف Jack لاستخدام أدوات Java 8 المحسّنة المضمّنة في مجموعة الأدوات التلقائية. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة استخدام ميزات لغة Java 8.

• تمت إضافة ميزة إتاحة إجراء الاختبارات باستخدام منصّة تنسيق اختبارات Android، ما يتيح لك إجراء كل اختبارات تطبيقك ضمن طلب أداة Instrumentation الخاص به. بما أنّ كل اختبار يتم تشغيله في مثيل أدوات القياس الخاص به، لا تتراكم أي حالة مشترَكة بين الاختبارات في وحدة المعالجة المركزية أو الذاكرة على جهازك. وحتى إذا تعطّل اختبار واحد، لن يؤدي ذلك إلا إلى إيقاف نسخة أداة Instrumentation الخاصة به، ما يضمن استمرار تنفيذ اختباراتك الأخرى.

  • تمت إضافة testOptions.execution لتحديد ما إذا كان سيتم استخدام عملية تنسيق الاختبار على الجهاز. إذا كنت تريد استخدام أداة "تنسيق اختبارات Android"، عليك تحديد ANDROID_TEST_ORCHESTRATOR، كما هو موضّح أدناه. يتم ضبط هذه السمة تلقائيًا على HOST، ما يؤدي إلى إيقاف عملية التنسيق على الجهاز، وهي الطريقة العادية لإجراء الاختبارات.

  رائع

          android {
            testOptions {
              execution 'ANDROID_TEST_ORCHESTRATOR'
            }
          }
          

  Kotlin

          android {
            testOptions {
              execution = "ANDROID_TEST_ORCHESTRATOR"
            }
          }
          

• تتيح لك إعدادات الاعتماد الجديدة على androidTestUtil تثبيت حزمة APK أخرى لمساعدة الاختبار قبل تشغيل اختبارات أداة القياس، مثل أداة "تنسيق اختبارات Android":

  رائع

          dependencies {
            androidTestUtil 'com.android.support.test:orchestrator:1.0.0'
            ...
          }
          

  Kotlin

          dependencies {
            androidTestUtil("com.android.support.test:orchestrator:1.0.0")
            ...
          }
          

• تمت إضافة testOptions.unitTests.includeAndroidResources لتوفير إمكانية إجراء اختبارات الوحدة التي تتطلّب موارد Android، مثل Roboelectric. عند ضبط هذه السمة على true، يُجري المكوّن الإضافي عملية دمج للموارد ومواد العرض والملفات البيانية قبل تشغيل اختبارات الوحدات. يمكن لاختباراتك بعد ذلك التحقّق من com/android/tools/test_config.properties فيملف com/android/tools/test_config.properties classpath للمفاتيح التالية:

  • android_merged_assets: المسار المطلق إلى دليل مواد العرض المدمجة

    ملاحظة: بالنسبة إلى وحدات المكتبة، لا تحتوي مواد العرض المدمجة على مواد عرض الملحقات (راجِع المشكلة رقم 65550419).

  • ‫android_merged_manifest: المسار المطلق إلىملف البيان المدمج

  • ‫android_merged_resources: المسار المطلق إلى دليل الموارد المدمجة، الذي يحتوي على جميع الموارد من الوحدة وجميع العناصر التي تعتمد عليها.

  • ‫android_custom_package: اسم حزمة فئة R النهائية في حال تعديل رقم تعريف التطبيق ديناميكيًا، قد لا يتطابق اسم الحزمة package مع سمة package في ملف بيان تطبيقك.

• إتاحة استخدام الخطوط كموارد (وهي ميزة جديدة تم تقديمها في Android 8.0 (المستوى 26 لواجهة برمجة التطبيقات))
• إتاحة ملفات APK المخصّصة للغة مع حزمة تطوير البرامج (SDK) 1.1 لتطبيقات Android الفورية والإصدارات الأحدث

• يمكنك الآن تغيير دليل الإخراج لمشروع الإصدار المتوافق مع الأجهزة التلقائية الخارجي، كما هو موضّح أدناه:

  رائع

          android {
              ...
              externalNativeBuild {
                  // For ndk-build, instead use the ndkBuild block.
                  cmake {
                      ...
                      // Specifies a relative path for outputs from external native
                      // builds. You can specify any path that's not a subdirectory
                      // of your project's temporary build/ directory.
                      buildStagingDirectory "./outputs/cmake"
                  }
              }
          }
          

  Kotlin

          android {
              ...
              externalNativeBuild {
                  // For ndk-build, instead use the ndkBuild block.
                  cmake {
                      ...
                      // Specifies a relative path for outputs from external native
                      // builds. You can specify any path that's not a subdirectory
                      // of your project's temporary build/ directory.
                      buildStagingDirectory = "./outputs/cmake"
                  }
              }
          }
          

• يمكنك الآن استخدام CMake 3.7 أو إصدار أحدث عند إنشاء مشاريع أصلية من Android Studio.

• تتيح لك إعدادات التبعيات الجديدة في lintChecks إنشاء حزمة JAR تحدّد قواعد lint مخصّصة، وتُحزِّمها في مشاريع AAR وAPK.

  يجب أن تنتمي قواعد lint المخصّصة إلى مشروع منفصل يُنشئملف JAR واحدًا ويتضمّن فقط تبعيات compileOnly. يمكن بعد ذلك أن تعتمد وحدات التطبيقات والمكتبات الأخرى على مشروع lint باستخدام إعدادات lintChecks:

  رائع

          dependencies {
              // This tells the Gradle plugin to build ':lint-checks' into a lint.jar file
              // and package it with your module. If the module is an Android library,
              // other projects that depend on it automatically use the lint checks.
              // If the module is an app, lint includes these rules when analyzing the app.
              lintChecks project(':lint-checks')
          }
          

  Kotlin

          dependencies {
              // This tells the Gradle plugin to build ':lint-checks' into a lint.jar file
              // and package it with your module. If the module is an Android library,
              // other projects that depend on it automatically use the lint checks.
              // If the module is an app, lint includes these rules when analyzing the app.
              lintChecks(project(":lint-checks"))
          }
          

تغييرات السلوك

• يزيل المكوّن الإضافي لنظام Android 3.0.0 واجهات برمجة تطبيقات معيّنة، وسيتم إيقاف عملية التصميم إذا كنت تستخدمها. على سبيل المثال، لم يعُد بإمكانك استخدام Variants API لمحاولة الوصول إلى عناصر outputFile() أو استخدام processManifest.manifestOutputFile() للحصول على ملف البيان لكلّ صيغة. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في واجهة برمجة التطبيقات.
• لم تعُد بحاجة إلى تحديد إصدار لأدوات الإنشاء (وبالتالي، يمكنك الآن إزالة سمة android.buildToolsVersion). بشكلٍ تلقائي، يستخدم المكوّن الإضافي الحد الأدنى من إصدار أدوات الإنشاء المطلوب لإصدار المكوّن الإضافي لنظام التشغيل Android الذي تستخدمه.
• يمكنك الآن تفعيل ميزة "ضغط ملفات PNG" أو إيقافها في القسم buildTypes كما هو موضّح أدناه. يتم تفعيل ميزة تقليل حجم ملفات PNG تلقائيًا لجميع عمليات الإنشاء باستثناء عمليات إنشاء تصحيح الأخطاء لأنّها تزيد من أوقات إنشاء المشاريع التي تتضمّن العديد من ملفات PNG. لذلك، لتحسين أوقات إنشاء أنواع الإصدارات الأخرى، عليك إيقاف ميزة تقليل حجم ملفات PNG أو تحويل صورك إلى WebP.

  رائع

        android {
          buildTypes {
            release {
              // Disables PNG crunching for the release build type.
              crunchPngs false
            }
          }
        }
        

  Kotlin

        android {
          buildTypes {
            release {
              // Disables PNG crunching for the release build type.
              isCrunchPngs = false
            }
          }
        }
        

• ينشئ المكوّن الإضافي لنظام التشغيل Android الآن تلقائيًا استهدافات قابلة للتنفيذ يمكنك ضبطها في مشاريع CMake الخارجية.
• عليك الآن إضافة معالجات التعليقات التوضيحية إلى مسار تحميل المعالج باستخدام إعدادات التبعياتannotationProcessor.
• أصبح استخدام ndkCompile المتوقّف نهائيًا أكثر تقييدًا الآن. بدلاً من ذلك، عليك نقل البيانات لاستخدام CMake أو ndk-build لتجميع الرمز الأصلي الذي تريد حزمه في حزمة APK. لمعرفة المزيد من المعلومات، يُرجى الاطّلاع على مقالة نقل البيانات من ndkcompile.

2.3.0 (شباط/فبراير 2017)

التبعيات:

• ‫Gradle 3.3 أو إصدار أحدث
• الإصدار 25.0.0 من "أدوات الإنشاء" أو إصدار أحدث

جديد:

• يستخدم Gradle 3.3 الذي يتضمّن تحسينات في الأداء وميزات جديدة. لمزيد من التفاصيل، يُرجى الاطّلاع على ملاحظات إصدار Gradle.
• ذاكرة التخزين المؤقت للإنشاء: تخزِّن نتائج معيّنة ينشئها المكوّن الإضافي لنظام Android عند إنشاء مشروعك (مثل حِزم AAR غير المُعبَّأة والتبعيات البعيدة التي تم تحويلها إلى ملف DEX مسبقًا). تكون عمليات الإنشاء النظيفة أسرع بكثير أثناء استخدام ذاكرة التخزين المؤقت لأنّ نظام الإنشاء يمكنه إعادة استخدام هذه الملفات المخزّنة مؤقتًا أثناء عمليات الإنشاء اللاحقة بدلاً من إعادة إنشائها. تستخدم المشاريع التي تستخدم المكوّن الإضافي لنظام التشغيل Android 2.3.0 والإصدارات الأحدث ذاكرة التخزين المؤقت للإنشاء تلقائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تحسين سرعة الإنشاء باستخدام ذاكرة التخزين المؤقت للإنشاء.
  • تتضمّن مهمة cleanBuildCache التي تُمحو ذاكرة التخزين المؤقت للإنشاء.
  • إذا كنت تستخدم الإصدار التجريبي من ذاكرة التخزين المؤقت للإنشاء (المضمّنة في الإصدارات السابقة من المكوّن الإضافي)، عليك تحديث المكوّن الإضافي إلى أحدث إصدار.

التغييرات:

• تتيح التغييرات على ميزة "التشغيل الفوري" المضمّنة في استوديو Android 2.3.
• من المفترض أن تكون مدة الإعداد للمشاريع الكبيرة جدًا أسرع بكثير.
• تم إصلاح المشاكل المتعلّقة بالتنزيل التلقائي لملف مكتبة constraint layout.
• يستخدم المكوِّن الإضافي الآن الإصدار 5.3.2 من ProGuard.
• تتضمّن العديد من الإصلاحات ل الأخطاء التي تم الإبلاغ عنها. يُرجى مواصلة إرسال تقارير الأخطاء عند مواجهة مشاكل.

2.2.0 (أيلول/سبتمبر 2016)

التبعيات:

• ‫Gradle 2.14.1 أو إصدار أحدث
• أدوات الإنشاء 23.0.2 أو إصدار أحدث

جديد:

• يستخدم Gradle 2.14.1 الذي يتضمّن تحسينات في الأداء وميزات جديدة، ويصلح ثغرة أمنية تسمح بتصعيد الأذونات المحلية عند استخدام برنامج Gradle الخفي. لمزيد من التفاصيل، يُرجى الاطّلاع على ملاحظات إصدار Gradle.
• باستخدام لغة برمجة externalNativeBuild {}، يتيح لك Gradle الآن الربط بمصادرك الأصلية وتجميع المكتبات الأصلية باستخدام CMake أو ndk-build. بعد إنشاء المكتبات المجمّعة من رموز برمجية أصلية، يُجمّعها Gradle في حزمة APK. للاطّلاع على مزيد من المعلومات عن استخدام CMake و ndk-build مع Gradle، يُرجى قراءة مقالة إضافة رمز C وC++ إلى مشروعك.
• عند تشغيل عملية إنشاء من سطر الأوامر، يحاول Gradle الآن تنزيل أيّ مكوّنات أو تحديثات غير متوفّرة من حزمة SDK يعتمد عليها مشروعك تلقائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التنزيل التلقائي للحِزم غير المتوفّرة باستخدام Gradle.
• تتيح ميزة التخزين المؤقت التجريبية الجديدة لـ Gradle تسريع مدّة الإنشاء من خلال تحويل ملف APK إلى ملف DEX مسبقًا وتخزينه وإعادة استخدامه في مكتباتك. لمزيد من المعلومات عن استخدام هذه الميزة التجريبية، يمكنك الاطّلاع على دليل إنشاء ذاكرة التخزين المؤقت.
• تحسين أداء عملية الإنشاء من خلال استخدام مسار جديد تلقائي لتعبئة التطبيقات يمكنه التعامل مع ضغط الملفات وتوقيعها ومواءمتها في مهمة واحدة يمكنك الرجوع إلى استخدام أدوات الحزمة القديمة من خلال إضافة android.useOldPackaging=true إلى ملف gradle.properties. أثناء استخدام أداة الحزمة الجديدة ، لا تتوفّر مهمة zipalignDebug. ومع ذلك، يمكنك إنشاء نموذج بنفسك من خلال استدعاء الأسلوب createZipAlignTask(String taskName, File inputFile, File outputFile).
• يستخدم توقيع حِزم APK الآن الإصدار 2 من مخطّط توقيع حِزم APK بالإضافة إلى توقيع JAR التقليدي. تقبل جميع أنظمة Android حِزم APK الناتجة. ويؤدي أي تعديل على حِزم APK هذه بعد التوقيع إلى إبطال توقيعات الإصدار 2 ومنع تثبيتها على الجهاز. لإيقاف هذه الميزة، أضِف ما يلي إلى ملف build.gradle على مستوى الوحدة:

  رائع

  android {
    ...
    signingConfigs {
      config {
        ...
        v2SigningEnabled false
      }
    }
  }
        

  Kotlin

  android {
    ...
    signingConfigs {
      create("config") {
        ...
        v2SigningEnabled = false
      }
    }
  }
        

• بالنسبة إلى عمليات إنشاء حِزم متعددة بتنسيق DEX، يمكنك الآن استخدام قواعد ProGuard لتحديد الفئات التي يجب أن يجمعها Gradle في ملف DEX الرئيسي لتطبيقك. بما أنّه يحمِّل نظام Android ملف DEX الرئيسي أولاً عند بدء تشغيل تطبيقك، يمكنك منح الأولوية لفئات معيّنة عند بدء التشغيل من خلال تجميعها في ملف DEX الرئيسي. بعد إنشاء ملف إعدادات ProGuard خصيصًا لملف ملف ‎DEXE الرئيسي، يمكنك تمرير مسار ملف الإعدادات إلى Gradle باستخدام buildTypes.multiDexKeepProguard. يختلف استخدام لغة الترميز هذه عن استخدام buildTypes.proguardFiles، التي توفّر قواعد عامة في ProGuard لتطبيقك ولا تحدّد فئات لملف DEX الرئيسي.
• إضافة علامة android:extractNativeLibs التي يمكن أن تقلّل حجم تطبيقك عند تثبيته على جهاز عند ضبط هذه العلامة على false في عنصر <application> في بيان تطبيقك، تحزم Gradle إصدارات غير مضغوطة ومحسَّنة من مكتباتك المجمّعة من رموز برمجية أصلية مع حزمة APK. يمنع ذلك أداة PackageManager من نسخ مكتباتك المجمّعة من رموز برمجية أصلية من حزمة APK إلى نظامملفات الجهاز أثناء التثبيت، كما أنّه يساهم في تقليل حجم التحديثات المعدَّلة لتطبيقك.
• يمكنك الآن تحديد versionNameSuffix و applicationIdSuffix لأنواع المنتجات. (المشكلة 59614)

التغييرات:

• getDefaultProguardFile يعرض الآن ملفات ProGuard الافتراضية التي يوفّرها المكوّن الإضافي لنظام Android في Gradle، ولم يعُد يستخدم الملفات المتوفّرة في حزمة SDK لنظام Android.
• ميزات وأداء محسّنان لمجمّع Jack:
  • يتيح Jack الآن تغطية اختبارات Jacoco عند ضبط testCoverageEnabled على true.
  • تحسين التوافق مع معالجات التعليقات التوضيحية يتم تلقائيًا تطبيق معالجات التعليقات المركّزة في مسار الفصل، مثل أي تبعيات compile ، على عملية الإنشاء. يمكنك أيضًا تحديد معالِج تعليقات توضيحية في عملية الإنشاء وتقديم الوسيطات باستخدام لغة برمجة javaCompileOptions.annotationProcessorOptions {} فيملف build.gradle على مستوى الوحدة:

    رائع

    android {
      ...
      defaultConfig {
        ...
        javaCompileOptions {
          annotationProcessorOptions {
            className 'com.example.MyProcessor'
            // Arguments are optional.
            arguments = [ foo : 'bar' ]
          }
        }
      }
    }
        

    Kotlin

    android {
      ...
      defaultConfig {
        ...
        javaCompileOptions {
          annotationProcessorOptions {
            className = "com.example.MyProcessor"
            // Arguments are optional.
            arguments(mapOf(foo to "bar"))
          }
        }
      }
    }
        

    إذا كنت تريد تطبيق معالج تعليقات توضيحية أثناء compiling ولكن لا تريد تضمينه في حزمة APK، استخدِم annotationProcessor نطاق الاعتماد:

    رائع

    dependencies {
        compile 'com.google.dagger:dagger:2.0'
        annotationProcessor 'com.google.dagger:dagger-compiler:2.0'
       // or use buildVariantAnnotationProcessor to target a specific build variant
    }
        

    Kotlin

    dependencies {
        implementation("com.google.dagger:dagger:2.0")
        annotationProcessor("com.google.dagger:dagger-compiler:2.0")
       // or use buildVariantAnnotationProcessor to target a specific build variant
    }
        

  للحصول على قائمة بالمَعلمات التي يمكنك ضبطها، شغِّل ما يلي من سطر الأوامر:

  java -jar /build-tools/jack.jar --help-properties
  

  • بشكلٍ تلقائي، إذا كان حجم ذاكرة heap لخادم Gradle غير القابل للتشغيل في الخلفية هو 1.5 غيغابايت على الأقل، سيتم تشغيل Jack الآن في العملية نفسها التي يتم فيها تشغيل Gradle. لضبط حجم ملف heap الخاص بالديمون، أضِف ما يلي إلى ملف gradle.properties:

    # This sets the daemon heap size to 1.5GB.
    org.gradle.jvmargs=-Xmx1536M
    

2.1.0 (نيسان/أبريل 2016)

التبعيات:

• ‫Gradle 2.10 أو إصدار أحدث
• أدوات الإنشاء 23.0.2 أو إصدار أحدث

جديد:

• تمت إضافة إمكانية استخدام "إصدار N Developer Preview" وJDK 8 وميزات لغة Java 8 باستخدام سلسلة أدوات ‏Jack. لمزيد من المعلومات، يُرجى الاطّلاع على دليل معاينة الإصدار N.

  ملاحظة: لا تعمل ميزة التشغيل الفوري حاليًا مع Jack وسيتم إيقافها أثناء استخدام مجموعة الأدوات الجديدة. لا تحتاج إلى استخدام Jack إلا إذا كنت تُطوّر التطبيقات لإصدار N Preview وتريد استخدام ميزات لغة Java 8 المتاحة.

• تمت إضافة ميزة تلقائية لدمج Java بشكل تدريجي لتقليل وقت الدمج أثناء التطوير. ويتم ذلك من خلال إعادة تجميع أجزاء المصدر التي تغيّرت أو التي يجب إعادة تجميعها فقط. لإيقاف هذه الميزة، أضِف الرمز التالي إلى ملف build.gradle على مستوى الوحدة:

  رائع

  android {
    ...
    compileOptions {
      incremental false
    }
  }
  

  Kotlin

  android {
    ...
    compileOptions {
      incremental = false
    }
  }
  

• تمت إضافة ميزة فك ترميز أثناء التشغيل التي تُجري عملية فك الترميز ضمن عملية الإنشاء بدلاً من عمليات الأجهزة الافتراضية الخارجية المنفصلة. لا يؤدي ذلك إلى تسريع عملية إنشاء الإصدارات المتزايدة فحسب، بل يؤدي أيضًا إلى تسريع عملية إنشاء الإصدارات الكاملة. يتم تفعيل الميزة تلقائيًا للمشاريع التي ضبطت الحد الأقصى لحجم heap في برنامج Gradle الخفي على 2048 ميغابايت على الأقل. يمكنك إجراء ذلك من خلال تضمين ما يلي فيملف gradle.properties في مشروعك:

  ```none org.gradle.jvmargs = -Xmx2048m ```

  إذا حدّدت قيمة لمَعلمة javaMaxHeapSize في ملف build.gradle على مستوى الوحدة، عليك ضبط org.gradle.jvmargs على قيمة javaMaxHeapSize + 1024 ميغابايت. على سبيل المثال، إذا ضبطت javaMaxHeapSize على "2048m"، عليك إضافة ما يلي إلىملف gradle.properties في مشروعك:

  ```none org.gradle.jvmargs = -Xmx3072m ```

  لإيقاف ميزة "الترميز أثناء التشغيل"، أضِف الرمز البرمجي التالي إلى ملف build.gradle على مستوى الوحدة:

  رائع

  android {
    ...
    dexOptions {
        dexInProcess false
    }
  }
  

  Kotlin

  android {
    ...
    dexOptions {
        dexInProcess = false
    }
  }
  

2.0.0 (نيسان/أبريل 2016)

التبعيات:

• ‫Gradle 2.10 أو إصدار أحدث
• الإصدار 21.1.1 من "أدوات الإنشاء" أو إصدار أحدث

جديد:

• تفعيل ميزة التشغيل الفوري من خلال السماح بحقن رمز الآلة ودفع تعديلات الرموز البرمجية والموارد إلى تطبيق قيد التشغيل على المحاكي أو على جهاز فعلي
• تمّت إضافة إمكانية استخدام الإصدارات المتزايدة، حتى في حال عدم تشغيل التطبيق. تم تحسين أوقات الإنشاء الكاملة من خلال دفع التغييرات المتزايدة من خلال Android Debug Bridge إلى الجهاز المتصل.
• تمت إضافة maxProcessCount للتحكّم في عدد عمليات dex العاملة التي يمكن إنشاؤها بشكل متزامن. يحدِّد الرمز البرمجي التالي، في ملف build.gradle على مستوى الوحدة، الحد الأقصى لعدد العمليات المتزامنة إلى 4:

  رائع

  android {
    ...
    dexOptions {
      maxProcessCount = 4 // this is the default value
    }
  }
  

  Kotlin

  android {
    ...
    dexOptions {
      maxProcessCount = 4 // this is the default value
    }
  }
  

    </li>
  
    <li>Added an experimental code shrinker to support pre-dexing and reduce re-dexing
    of dependencies, which are not supported with Proguard. This improves the build
    speed of your debug build variant. Because the experimental shrinker does not
    support optimization and obfuscation, you should enable Proguard for your
    release builds. To enable the experimental shrinker for your debug builds, add
    the following to your module-level <code>build.gradle</code> file:
  

  رائع

  android {
    ...
    buildTypes {
      debug {
        minifyEnabled true
        useProguard false
      }
      release {
        minifyEnabled true
        useProguard true // this is a default setting
      }
    }
  }
  

  Kotlin

  android {
    ...
    buildTypes {
      getByName("debug") {
        minifyEnabled = true
        useProguard = false
      }
      getByName("release") {
        minifyEnabled = true
        useProguard = true // this is a default setting
      }
    }
  }
  

    </li>
  
    <li>Added logging support and improved performance for the resource shrinker.
    The resource shrinker now logs all of its operations into a <code>resources.txt</code>
    file located in the same folder as the Proguard log files.
    </li>
  </ul>
  

السلوك المتغيّر:

• عند ضبط minSdkVersion على 18 أو إصدار أحدث، يستخدم توقيع حِزمة APK SHA256.

  <li>DSA and ECDSA keys can now sign APK packages.

    <p class="note">
      <strong>Note:</strong> The <a href=
      "/training/articles/keystore.html">Android keystore</a> provider no
      longer supports <a href=
      "/about/versions/marshmallow/android-6.0-changes.html#behavior-keystore">
      DSA keys on Android 6.0</a> (API level 23) and higher.
    </p>

  </li>
</ul>

المشاكل التي تم إصلاحها:

• تم إصلاح مشكلة أدّت إلى تكرار التبعيات في AAR في كل من إعدادات الإصدار التجريبي والإصدار الرئيسي.

المكوّن الإضافي المتوافق مع Android لنظام Gradle، المراجعة 1.5.0 (تشرين الثاني (نوفمبر) 2015)

التبعيات:

• ‫Gradle 2.2.1 أو إصدار أحدث
• الإصدار 21.1.1 من "أدوات الإنشاء" أو إصدار أحدث

ملاحظات عامة:

• تم دمج المكوّن الإضافي لربط البيانات في المكوّن الإضافي لنظام Android المتوافق مع Gradle. لتفعيل هذه الميزة، أضِف الرمز التالي إلى كل ملف build.gradle لكل مشروع يستخدم مكوّنًا إضافيًا:

android {
    dataBinding {
        enabled = true
    }
}
        

android {
    dataBinding {
        enabled = true
    }
}
        

• تمت إضافة واجهة برمجة تطبيقات جديدة Transform API للسماح للمكوّنات الإضافية التابعة لجهات خارجية بمعالجة ملفات .class المجمّعة قبل تحويلها إلى ملفات .dex. تعمل Transform API على تبسيط عمليات تعديل الفئات المخصّصة مع توفير مرونة أكبر في ما يتعلّق بما يمكنك تعديله. لإدراج تحويل في إصدار، أنشئ فئة جديدة تنفِّذ إحدى واجهات Transform ، وسجِّلها باستخدام android.registerTransform(theTransform) أو android.registerTransform(theTransform, dependencies). ليس عليك ربط المهام ببعضها. يُرجى مراعاة ما يلي بشأن Transform API:
• يمكن تطبيق التحويل على واحد أو أكثر مما يلي: المشروع الحالي والمشاريع الفرعية والمكتبات الخارجية.
• يجب تسجيل التحويل على مستوى العالم، ما يؤدي إلى تطبيقه على جميع الصيغ.
• تستخدم الآن معالجة الرموز البرمجية الداخلية، من خلال مكتبة Java Code Coverage Library ‏ (JaCoCo) وProGuard وMultiDex، واجهة برمجة التطبيقات Transform API. ومع ذلك، لا تستخدم مجموعة أدوات Java Android Compiler Kit (Jack) واجهة برمجة التطبيقات هذه: لا يستخدمها سوى مسار الرمز البرمجي javac/dx.
• ينفِّذ Gradle عمليات التحويل بالترتيب التالي: JaCoCo، والمكونات الإضافية التابعة لجهات خارجية، وProGuard. يتطابق ترتيب تنفيذ المكوّنات الإضافية التابعة لجهات خارجية مع الترتيب الذي تتم فيه إضافة عمليات التحويل من خلال المكوّنات الإضافية التابعة لجهات خارجية، ولا يمكن لمطوّري المكوّنات الإضافية التابعة لجهات خارجية التحكّم في ترتيب تنفيذ عمليات التحويل من خلال واجهة برمجة التطبيقات.
• تم إيقاف دالة الحصول على dex نهائيًا من فئة ApplicationVariant. لا يمكنك الوصول إلى مهمة Dex من خلال واجهة برمجة التطبيقات لأنواع الأسعار بعد الآن لأنّه يتم الآن إكمالها من خلال عملية تحويل. ليس هناك حاليًا بديل للتحكّم في عملية dex.
• تمّت معالجة مشكلة عدم توفّر مواد عرض إضافية.
• تحسين دعم MultiDex من خلال إتاحة استخدامه في المشاريع الاختبارية، وأصبح الآن لدى الاختبار تلقائيًا التبعية com.android.support:multidex-instrumentation.
• تمت إضافة إمكانية إيقاف عملية إنشاء Gradle بشكل صحيح والإبلاغ عن سبب الخطأ الأساسي عندما يستدعي إنشاء Gradle مهامًا غير متزامنة ويحدث تعذّر في عملية العامل.
• تمّت إضافة إمكانية ضبط واجهة تطبيق ثنائية (ABI) معيّنة في الصيغ التي تحتوي على واجهات ABI متعددة.
• تمت إضافة إمكانية استخدام قائمة مفصولة بفواصل لأرقام الأجهزة التسلسلية لمتغيّر البيئة ANDROID_SERIAL عند تثبيت الاختبارات أو تشغيلها.
• تم إصلاح مشكلة تعذُّر التثبيت على الأجهزة التي تعمل بالإصدار 5.0 من نظام التشغيل Android (المستوى 20 من واجهة برمجة التطبيقات) والإصدارات الأحدث عندما يحتوي اسم حزمة APK على مسافة.
• تم إصلاح مشاكل مختلفة متعلقة بإخراج أخطاء أداة تجميع الموارد في Android (AAPT).
• تمت إضافة دعم لأدوات القياس التزايدي في JaCoCo من أجل عمليات الإنشاء المتزايدة بشكل أسرع. يُستخدَم الآن المكوّن الإضافي لنظام Gradle المتوافق مع Android لتشغيل أداة فحص JaCoCo مباشرةً. لفرض استخدام إصدار أحدث من أداة فحص JaCoCo، عليك إضافته كعنصر تابع لنص إنشاء البرنامج.
• تم إصلاح مشكلة توفُّر JaCoCo بحيث يتجاهل الملفات التي ليست فئات.
• تمت إضافة إمكانية استخدام الرسومات المتجهّة لإنشاء ملفات بتنسيق PNG في وقت التصميم من أجل التوافق مع الإصدارات القديمة. ينشئ المكوّن الإضافي لنظام Android المتوافق مع Gradle ملفات بتنسيق PNG لكل عنصر قابل للرسم بتنسيق ملفات رسومات متجهة تم العثور عليه في دليل موارد لا يحدّد إصدار واجهة برمجة التطبيقات أو يحدّد سمة android:minSdkVersion بقيمة 20 أو أقل في عنصر <uses-sdk> في بيان التطبيق. يمكنك ضبط كثافة ملفات PNG من خلال استخدام السمة generatedDensities في قسمَي defaultConfig أو productFlavor من ملف build.gradle.
• تمت إضافة ميزة مشاركة android.jar القابلة للمحاكاة، والتي ينشئها المكوّن الإضافي مرة واحدة فقط ويستخدمها لاختبار الوحدات. تتشارك الآن وحدات متعدّدة هذه البيانات، مثل app و lib. احذف $rootDir/build لإعادة إنشائه.
• تم تغيير معالجة موارد Java لتتم قبل مهام التشويش بدلاً من أثناء تجميع حزمة APK. يسمح هذا التغيير لمهام التشويش بتعديل موارد Java بعد تشويش الحِزم.
• تم إصلاح مشكلة في استخدام رمز Java Native Interface (JNI) في المكوّن الإضافي لـ المكتبة التجريبية.
• تمت إضافة إمكانية ضبط إصدار النظام الأساسي بشكل منفصل عن سمة android:compileSdkVersion في المكوّن الإضافي للمكتبة التجريبية.

المكوّن الإضافي لنظام Gradle المتوافق مع Android، المراجعة 1.3.1 (آب/أغسطس 2015)

• ‫Gradle 2.2.1 أو إصدار أحدث
• الإصدار 21.1.1 من "أدوات الإنشاء" أو إصدار أحدث

• تم إصلاح مهمة ZipAlign لكي تستخدم بشكلٍ سليم نتيجة المهمة السابقة عند استخدام اسم ملف مخصّص.
• تم إصلاح مشكلة تتعلق بتعبئة Renderscript باستخدام NDK.
• تم الاحتفاظ بإمكانية استخدام مهمة إنشاء createDebugCoverageReport.
• تم إصلاح مشكلة عدم توفّر الدعم لاستخدام السمة archiveBaseName المخصّصة في ملف الإنشاء build.gradle.
• تم إصلاح تحذير Invalid ResourceType lint الناتج عن طريقة المَعلمة lookup للتعليق التوضيحي عند تشغيل lint خارج "استوديو Android".

المكوّن الإضافي لنظام Gradle المتوافق مع Android، المراجعة 1.3.0 (تموز/يوليو 2015)

• ‫Gradle 2.2.1 أو إصدار أحدث
• الإصدار 21.1.1 من "أدوات الإنشاء" أو إصدار أحدث

• تمت إضافة دعم للسمة com.android.build.threadPoolSize للتحكّم في حجم مجموعة مؤشرات الترابط المخصّصة لمهام Android من الملف gradle.properties أو سطر الأوامر. يضبط المثال التالي هذه السمة على 4.

          
          -Pcom.android.build.threadPoolSize=4
          
        

• اضبط السلوك التلقائي للإنشاء لاستبعاد ملفات LICENSE وLICENSE.txt من حِزم APK. لتضمين هذه الملفات في حزمة APK، عليك إزالة هذه الملفات من ملف build.gradle في ملف packagingOptions.excludes. مثلاً:

  android {
        packagingOptions.excludes = []
      }
        

  android {
        packagingOptions.excludes.clear()
      }
      

• تمت إضافة مهمة sourceSets لتفقد مجموعة جميع مجموعات المصادر المتاحة.
• تحسين اختبار الوحدة للتعرّف على المجلدات المصدر الخاصة بالإصدارات المتعددة و خيارات الإصدار على سبيل المثال، لاختبار تطبيق يتضمّن تصاميم متعددة flavor1 وflavorA بنوع الإصدار Debug، تكون مجموعات مصادر الاختبار على النحو التالي:
  • اختبار
  • testFlavor1
  • testFlavorA
  • testFlavor1FlavorA
  • testFlavor1FlavorADebug

  كانت اختبارات Android تُعرِف ملفات المصدر المتعدّدة النُسخ.

• تحسين دعم اختبار الوحدة لإجراء ما يلي:
  • يمكنك تشغيل javac على المصدرَين الرئيسي والاختباري، حتى إذا تم ضبط القيمة useJack على true في ملف الإنشاء.
  • التعرّف بشكل صحيح على التبعيات لكل نوع من أنواع الإنشاء
• تمت إضافة إمكانية تحديد وسيطات أداة تشغيل اختبارات الأدوات من سطر الأوامر. على سبيل المثال:

  ./gradlew connectedCheck \
     -Pandroid.testInstrumentationRunnerArguments.size=medium \
     -Pandroid.testInstrumentationRunnerArguments.class=TestA,TestB
          

• تمت إضافة دعم لمَعلمات إضافية عشوائية لأداة حزمة مواد عرض Android (AAPT) في ملف build.gradle. مثلاً:

  android {
      aaptOptions {
        additionalParameters "--custom_option", "value"
      }
  }
        

  android {
      aaptOptions {
        additionalParameters += listOf("--custom_option", "value")
      }
  }
        

• تمت إضافة إمكانية استخدام وحدة اختبار حزمة APK كوحدة اختبار منفصلة، وذلك باستخدام السمتَين targetProjectPath وtargetVariant لضبط مسار APK والصيغة المستهدَفة.

  ملاحظة: لا تتوافق وحدة حزمة APK الاختبارية مع نكهات المنتج ولا يمكنها استهداف سوى سعر متغير واحد. بالإضافة إلى ذلك، لا تتوفّر أداة Jacoco بعد.

• تمت إضافة عملية التحقّق من اسم المورد قبل دمج الموارد.
• عند إنشاء حزمة AAR (أرشيف Android) لوحدات المكتبة، لا تقدِّم العنصر النائب @{applicationId} التلقائي في إعداداتدمج البيان. بدلاً من ذلك، استخدِم عنصر نائبًا مختلفًا، مثل @{libApplicationId} و قدِّم قيمة له إذا أردت تضمين أرقام تعريف التطبيقات في مكتبة الأرشيف.

المكوّن الإضافي لنظام Android المتوافق مع Gradle، المراجعة 1.2.0 (نيسان (أبريل) 2015)

التبعيات:

• ‫Gradle 2.2.1 أو إصدار أحدث
• الإصدار 21.1.1 من "أدوات الإنشاء" أو إصدار أحدث

ملاحظات عامة:

• تحسين التوافق مع اختبارات الوحدة باستخدام Gradle
  • تم توفير إمكانية تضمين المراجع بأسلوب Java في مسار الطباعة عند تشغيل اختبارات الوحدة مباشرةً من Gradle.
  • تمت إضافة إمكانية استخدام اختبار الوحدة مع عناصر أرشيف Android (AAR).
  • تمت إضافة إمكانية استخدام سمة unitTestVariants حتى يمكن التلاعب بنُسخ اختبار الوحدة باستخدامملف build.gradle.
  • تمت إضافة مجموعة الرموز unitTest.all ضمن testOptions لضبط المهام المخصّصة لاختبار الوحد ة. يوضّح الرمز البرمجي النموذجي التالي كيفية إضافة إعدادات ملف الضبط لاختبار الوحدة باستخدام هذا الخيار الجديد:

    android {
      testOptions {
        unitTest.all {
          jvmArgs '-XX:MaxPermSize=256m' // Or any other gradle option.
        }
      }
    }
    

    android {
      testOptions {
        unitTest.all {
          jvmArgs += listOf("-XX:MaxPermSize=256m") // Or any other gradle option.
        }
      }
    }
                

  • تم إصلاح معالجة الحقول المحددة والحقول العامة للمثيل في حزمة ملف mockable-android.jar.
  • تم إصلاح تبعيات مهام مشروع المكتبة حتى تتم إعادة تجميع فئات الاختبار بعد إجراء التغييرات.
• تمت إضافة السمة testProguardFile لتطبيق ملفّات ProGuard عند تصغير حزمة APK اختبارية.
• تمت إضافة السمة timeOut إلى كتلة رمز adbOptions لضبط الحد الأقصى لوقت التسجيل لتسجيل شاشة Android Debug Bridge.
• تمت إضافة إمكانية استخدام ملفات بدقة 280 نقطة لكل بوصة.
• تحسين الأداء أثناء تقييم المشروع

المكوّن الإضافي لنظام Android المتوافق مع Gradle، المراجعة 1.1.3 (آذار (مارس) 2015)

التبعيات:

• ‫Gradle 2.2.1 أو إصدار أحدث
• الإصدار 21.1.1 من "أدوات الإنشاء" أو إصدار أحدث

ملاحظات عامة:

• تم إصلاح مشكلة تتعلق بالتبعيات المكرّرة في تطبيق اختباري أدّت إلى تعذُّر استخدام ProGuard.
• تم إصلاح تنفيذ Comparator الذي لم يكن متوافقًا مع اتّفاقية Comparator في JDK و أدّى إلى حدوث خطأ في JDK 7.

المكوّن الإضافي المتوافق مع Android لنظام Gradle، المراجعة 1.1.2 (شباط/فبراير 2015)

التبعيات:

• ‫Gradle 2.2.1 أو إصدار أحدث
• الإصدار 21.1.1 من "أدوات الإنشاء" أو إصدار أحدث

ملاحظات عامة:

• المسار المنسَّق عند إنشاء حزمة JAR قابلة للمحاكاة لاختبار الوحدات
• تم إصلاح إعداد archivesBaseName فيملف build.gradle.
• تم إصلاح مشكلة تعذُّر حلّ مشكلة العنصر النائب في دمج البيان عند إنشاء تطبيق اختبار مكتبة.

المكوّن الإضافي المتوافق مع Android لنظام Gradle، المراجعة 1.1.1 (شباط/فبراير 2015)

التبعيات:

• ‫Gradle 2.2.1 أو إصدار أحدث
• الإصدار 21.1.1 من "أدوات الإنشاء" أو إصدار أحدث

ملاحظات عامة:

• تم تعديل صِيغ الإصدارات لكي لا تُنفِّذ سوى الصِيغ التي تحزِّم عامل تشغيل تطبيق Wear مهام الإنشاء الخاصة بنظام التشغيل Wear.
• تم تغيير المشاكل المتعلقة بالتبعية لتؤدي إلى تعذُّر الإنشاء في وقت الإنشاء بدلاً من وقت تصحيح الأخطاء. يتيح لك هذا السلوك تنفيذ مهام تشخيص (مثل "التبعيات") للمساعدة في حلّ التعارض.
• تم إصلاح الطريقة android.getBootClasspath() لمحاولة عرض قيمة.

المكوّن الإضافي المتوافق مع Android لنظام Gradle، المراجعة 1.1.0 (شباط/فبراير 2015)

التبعيات:

• ‫Gradle 2.2.1 أو إصدار أحدث
• الإصدار 21.1.1 من "أدوات الإنشاء" أو إصدار أحدث

ملاحظات عامة:

• إتاحة اختبار الوحدة الجديد
• تم تفعيل اختبارات الوحدة لتشغيلها على آلة Java الافتراضية المحلية مع إصدار خاص من ملف android.jar متوافق مع إطارات عمل المحاكاة الشائعة، مثل Mockito.
• تمت إضافة مهام اختبار جديدة testDebug testRelease وtestMyFlavorDebug عند استخدام أنواع المنتجات.
• تمت إضافة مجلدات مصدر جديدة تم التعرّف عليها كاختبارات وحدات: src/test/java/ وsrc/testDebug/java/ src/testMyFlavor/java/.
• تمت إضافة إعدادات جديدة في ملف build.gradle للإفصاح عن التبعيات للاختبار فقط، على سبيل المثال، testCompile 'junit:junit:4.11'، testMyFlavorCompile 'some:library:1.0'.

  ملاحظة: لا تتوافق حاليًا تبعيات الاختبار فقط مع Jack (مجموعة أدوات 컴ِلِر Java Android ‏).

• تمت إضافة خيار android.testOptions.unitTests.returnDefaultValues للتحكّم في سلوك android.jar القابل للمحاكاة.
• تم استبدال Test في أسماء مهام الاختبار بحرف AndroidTest. على سبيل المثال، أصبحت مهمة assembleDebugTest مهمة assembleDebugAndroidTest. لا تزال مهام اختبار الوحدات تحتوي على UnitTest في اسم المهمة، على سبيل المثال assembleDebugUnitTest.
• تعديل ملفات إعدادات ProGuard كي لا تعود سارية على حزمة APK الاختبارية في حال تفعيل التصغير، يعالج ProGuard حزمة APK الاختبارية ويطبّق فقط ملف الربط الذي يتم إنشاؤه عند تصغير حزمة APK الرئيسية.
• إدارة التبعية المعدَّلة
  • تم إصلاح المشاكل المتعلقة باستخدام نطاقَي provided و package.

    ملاحظة: هذه النطاقات غير متوافقة مع حِزم AAR (أرشيف Android) وستؤدي إلى تعذُّر إنشاء حِزم تتضمّن حِزم AAR.

  • تم تعديل حلّ التبعيات لمقارنة تبعيات تطبيق قيد الاختبار والتطبيق التجريبي. إذا تم العثور على عنصر برمجي بالإصدار نفسه لكلا التطبيقَين، لن يتم تضمينه في تطبيق الاختبار وسيتم حزمه مع التطبيق قيد الاختبار فقط. إذا تم العثور على عنصر بإصدار مختلف لكلا التطبيقَين، سيتعذّر إكمال عملية الإنشاء.
• تمت إضافة إمكانية استخدام anyDpi مؤهِّل المورد في دمج الموارد.
• سرعات تقييم ومزامنة بيئة تطوير تفاعلية محسّنة للمشاريع التي تحتوي على عدد كبير من وحدات Android

المكوّن الإضافي المتوافق مع Android لنظام Gradle، المراجعة 1.0.1 (كانون الثاني/يناير 2015)

التبعيات:

• ‫Gradle 2.2.1 حتى 2.3.x

  ملاحظة: لا يتوافق هذا الإصدار من المكوّن الإضافي لنظام Gradle المتوافق مع Android مع Gradle 2.4 والإصدارات الأحدث.

• الإصدار 21.1.1 من "أدوات الإنشاء" أو إصدار أحدث

ملاحظات عامة:

• تم إصلاح مشكلة تعذُّر إنشاء Gradle عند الوصول إلى وحدة extractReleaseAnnotations. (المشكلة 81638).
• تم إصلاح مشكلة Disable في تمرير الإعداد --no-optimize إلى رمز دالوايك التنفيذي (dex) الثنائي. (المشكلة 82662).
• تم حلّ مشاكل دمج البيان عند استيراد مكتبات تتضمن targetSdkVersion أقل من 16.
• تم إصلاح مشكلة ترتيب الكثافة عند استخدام "استوديو Android" معJDK 8.

المكوّن الإضافي المتوافق مع Android لنظام Gradle، المراجعة 1.0.0 (كانون الأول/ديسمبر 2014)

التبعيات:

• ‫Gradle 2.2.1 حتى 2.3.x

  ملاحظة: لا يتوافق هذا الإصدار من المكوّن الإضافي لنظام Gradle المتوافق مع Android مع الإصدار 2.4 من Gradle والإصدارات الأحدث.

• الإصدار 21.1.1 من "أدوات الإنشاء" أو إصدار أحدث

ملاحظات عامة:

• الإصدار الأولي للمكوّن الإضافي