Разработка Android - Где найти «оригинальную» непонятную документацию по компонентам - PullRequest
Новая
       31

Разработка Android - Где найти «оригинальную» непонятную документацию по компонентам

1 голос
/ 12 июня 2019

Мне было поручено создать приложение для Android, и в прошлом я немного изучал Android. Я посмотрел несколько видеоуроков с developer.android.com и немного разбираюсь в том, как работает Android, как устроена и работает система файлов.

В последнее время я изучаю возможность создания собственного стиля для различных компонентов, и сейчас я пытаюсь оформить ProgressBar. Я узнал, что атрибут progressDrawable может указывать на список слоев, который содержит элементы, стилизующие фон, ход и вторичный ход.

Что я не понимаю, так это как люди точно знают, какие идентификаторы включить в список слоев, и на что именно ссылаются эти идентификаторы? Я часами искал в интернете документацию, статьи, API-демоверсии, исходный код (Ctrl + Click в Android Studio) и т. Д. Но я не могу найти ни одного места, в котором упоминается, откуда эта информация изначально появилась. Как люди узнают, какие три идентификатора включить в список слоев? Было бы здорово, если бы кто-нибудь мог указать точно, где находится официальная информация о том, где и как эти идентификаторы из ids.xml используются в компонентах оформления.

Спасибо!

1 Ответ

2 голосов
/ 12 июня 2019

как люди точно знают, какие идентификаторы включить в список слоев, и на что именно ссылаются эти идентификаторы?

Если бы этого не было в ProgressBar документах, я бынайдите поставляемый фреймворк ProgressBar и посмотрите, что они сделали.Например, посмотрите на $ANDROID_SDK/platforms/android-$API/data/res/drawable/progress_horizontal_material.xml, где:

  • $ANDROID_SDK - это то место, где установлен Android SDK
  • $API - это уровень API, например 29 (примечание:так как я указываю вам на progress_horizontal_material.xml, уровень API должен быть 21 или выше)

Если вы посмотрите туда, вы увидите, что фоновый Theme.Material фон для ProgressBaris: 

<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (C) 2014 The Android Open Source Project

     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
     You may obtain a copy of the License at

          http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing, software
     distributed under the License is distributed on an "AS IS" BASIS,
     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     See the License for the specific language governing permissions and
     limitations under the License.
-->

<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:id="@id/background"
          android:gravity="center_vertical|fill_horizontal">
        <shape android:shape="rectangle"
               android:tint="?attr/colorProgressBackgroundNormal">
            <corners android:radius="?attr/progressBarCornerRadius" />
            <size android:height="@dimen/progress_bar_height_material" />
            <solid android:color="@color/white_disabled_material" />
        </shape>
    </item>
    <item android:id="@id/secondaryProgress"
          android:gravity="center_vertical|fill_horizontal">
        <scale android:scaleWidth="100%">
            <shape android:shape="rectangle"
                   android:tint="?attr/colorControlActivated">
                <corners android:radius="?attr/progressBarCornerRadius" />
                <size android:height="@dimen/progress_bar_height_material" />
                <solid android:color="@color/white_disabled_material" />
            </shape>
        </scale>
    </item>
    <item android:id="@id/progress"
          android:gravity="center_vertical|fill_horizontal">
        <scale android:scaleWidth="100%">
            <shape android:shape="rectangle"
                   android:tint="?attr/colorControlActivated">
                <corners android:radius="?attr/progressBarCornerRadius" />
                <size android:height="@dimen/progress_bar_height_material" />
                <solid android:color="@color/white" />
            </shape>
        </scale>
    </item>
</layer-list>

(на основе API уровня 29; другие версии могут отличаться, но, вероятно, незначительно)

Вы можете клонировать этот файл в каталог res/drawable/ вашего проекта, настроить его какнеобходимо, а затем используйте измененную версию.

IOW, если ее нет в документации, «официальной» информацией является исходный код Android.

Обратите внимание, что для Theme.Material, есливсе, что вам нужно сделать, это изменить цвета, вы можете оставить рисунок в покое и использовать различные атрибуты оттенка на ProgressBar.

...