این کد لبه بخشی از دوره آموزشی Android Kotlin Fundamentals است. اگر به ترتیب روی کدها کار کنید، بیشترین ارزش را از این دوره خواهید گرفت. همه کد لبه های دوره در صفحه فرود کد لبه های Android Kotlin Fundamentals فهرست شده اند.
مقدمه
در این کد لبه، شما با منابعی آشنا می شوید که برای توسعه دهندگان اندروید Kotlin مفید هستند، از جمله الگوها، اسناد، ویدئوها و برنامه های نمونه.
آنچه از قبل باید بدانید
- گردش کار اصلی اندروید استودیو.
- نحوه استفاده از Layout Editor در اندروید استودیو
چیزی که یاد خواهید گرفت
- اطلاعات و منابع توسعه دهندگان Kotlin و Android را از کجا می توان پیدا کرد.
- نحوه تغییر نماد راهانداز در یک برنامه
- چگونه هنگام ساخت برنامه های اندروید با استفاده از Kotlin به دنبال کمک باشیم.
کاری که خواهی کرد
- برخی از منابع موجود برای توسعه دهندگان اندروید Kotlin در تمام سطوح را کاوش کنید.
- یک برنامه نمونه اندروید Kotlin را دانلود و کاوش کنید.
- نماد راهانداز برنامه را تغییر دهید.
در این کد لبه، با قالب ها، نمونه ها، اسناد و سایر منابعی که برای توسعه دهندگان اندروید Kotlin در دسترس است، آشنا می شوید.
ابتدا یک برنامه ساده از یک قالب اندروید استودیو ایجاد می کنید و برنامه را تغییر می دهید. سپس برنامه نمونه Android Sunflower را دانلود و کاوش می کنید. نماد راهانداز برنامه نمونه (یک گل آفتابگردان) را با یک دارایی تصویر کلیپ آرت که در Android Studio موجود است (یک صورتک) جایگزین میکنید.
Android Studio الگوهایی را برای طراحی برنامهها و فعالیتهای رایج و پیشنهادی ارائه میکند. قالب های داخلی در وقت شما صرفه جویی می کنند و به شما کمک می کنند بهترین شیوه های طراحی را دنبال کنید.
هر الگو دارای یک فعالیت اسکلت و رابط کاربری است. شما قبلاً از الگوی Empty Activity در این دوره استفاده کرده اید. الگوی Basic Activity ویژگیهای بیشتری دارد و ویژگیهای برنامه پیشنهادی را در خود جای داده است، مانند منوی گزینهها که در نوار برنامه در دستگاههای مجهز به Android ظاهر میشود.
مرحله 1: معماری Basic Activity را کاوش کنید
- در Android Studio، یک پروژه ایجاد کنید.
- در گفتگوی Choose your project ، الگوی Basic Activity را انتخاب کرده و روی Next کلیک کنید.
- در گفتگوی پیکربندی پروژه خود ، نام برنامه را هر چه میخواهید بگذارید. Kotlin را برای زبان انتخاب کنید و کادر استفاده از مصنوعات AndroidX را انتخاب کنید. روی Finish کلیک کنید.
- برنامه را بسازید و آن را روی یک شبیه ساز یا دستگاه مجهز به اندروید اجرا کنید.
- قسمت های دارای برچسب را در شکل و جدول زیر مشخص کنید. معادل آنها را در صفحه نمایش دستگاه یا شبیه ساز خود پیدا کنید. کد Kotlin و فایل های XML مربوطه را که در جدول توضیح داده شده است، بررسی کنید.
آشنایی با کد منبع Kotlin و فایلهای XML به شما کمک میکند الگوی Basic Activity را برای نیازهای خود گسترش دهید و سفارشی کنید.
معماری الگوی فعالیت پایه

# | توضیحات رابط کاربری | مرجع کد |
1 | نوار وضعیت، که سیستم اندروید ارائه و کنترل می کند. | در کد الگو قابل مشاهده نیست، اما می توانید از فعالیت خود به نوار وضعیت دسترسی داشته باشید. برای مثال، میتوانید کدی را در |
2 | نوار برنامه که نوار اکشن نیز نامیده می شود، ساختار بصری، عناصر بصری استاندارد شده و ناوبری را ارائه می دهد. | در داخل عنصر AppBarLayout . برای سازگاری با عقب، برای تغییر ظاهر نوار برنامه، ویژگی های نوار ابزار را تغییر دهید. برای آموزش نوار برنامه، به افزودن نوار برنامه مراجعه کنید. |
3 | نام برنامه در ابتدا از نام بسته شما مشتق شده است، اما می توانید آن را به هر چیزی که می خواهید تغییر دهید. | در رشته |
4 | دکمه سرریز منوی گزینه ها آیتم های منو را برای فعالیت نگه می دارد. دکمه سرریز همچنین گزینههای منوی سراسری مانند جستجو و تنظیمات برنامه را نگه میدارد. آیتم های منوی برنامه شما به این منو می روند. | در متد برای دیدن آیتم های گزینه های منو، فایل فقط مورد منوی تنظیمات در این الگو مشخص شده است. |
5 | CoordinatorLayout | در |
6 | این الگو از TextView برای نمایش "Hello World" استفاده می کند. شما این | نمای متنی "Hello World" در فایل |
7 | دکمه حرکت شناور (FAB) | در |
مرحله 2: برنامه ای را که الگو تولید می کند سفارشی کنید
ظاهر برنامه تولید شده توسط قالب Basic Activity را تغییر دهید. به عنوان مثال، می توانید رنگ نوار برنامه را تغییر دهید تا با نوار وضعیت مطابقت داشته باشد. (در برخی از دستگاهها، نوار وضعیت یک سایه تیرهتر از همان رنگ اصلی است که نوار برنامه استفاده میکند.)
- نام برنامه ای که نوار برنامه نمایش داده می شود را تغییر دهید. برای انجام این کار، منبع رشته
app_name
را در فایل res > values > strings.xml به شکل زیر تغییر دهید:
<string name="app_name">New Application</string>
- با تغییر ویژگی
android:background
به"?attr/colorPrimaryDark"
رنگ نوار برنامه (Toolbar
) را در res > layout > activity_main.xml تغییر دهید. این مقدار رنگ نوار برنامه را روی یک رنگ اصلی تیره تر تنظیم می کند که با نوار وضعیت مطابقت دارد:
android:background="?attr/colorPrimaryDark"
- برنامه را اجرا کنید. نام جدید برنامه در نوار وضعیت ظاهر می شود و رنگ پس زمینه نوار برنامه تیره تر است و با رنگ نوار وضعیت مطابقت دارد. وقتی روی FAB کلیک میکنید، یک نوار اسنک ظاهر میشود که به صورت 1 در تصویر زیر نشان داده شده است.
- متن اسنکبار را تغییر دهید. برای انجام این کار،
MainActivity
باز کنید و به دنبال کد خرد درonCreate()
بگردید که شنوندهonClick()
را برای دکمه تنظیم می کند."Replace with your own action"
به چیز دیگری تغییر دهید. به عنوان مثال:
fab.setOnClickListener { view ->
Snackbar.make(view, "This FAB needs an action!", Snackbar.LENGTH_LONG)
.setAction("Action", null).show()
}
- FAB از رنگ لهجه برنامه استفاده می کند، بنابراین یکی از راه های تغییر رنگ FAB، تغییر رنگ تاکیدی است. برای تغییر رنگ لهجه، فایل res > values > colors.xml را باز کرده و مانند تصویر زیر، ویژگی
colorAccent
را تغییر دهید. (برای راهنمایی در انتخاب رنگ ها، به سیستم رنگ Material Design مراجعه کنید.)
<color name="colorAccent">#1DE9B6</color>
- برنامه را اجرا کنید. FAB از رنگ جدید استفاده می کند و متن اسنک بار تغییر کرده است.
مرحله 3: نحوه اضافه کردن فعالیت ها با استفاده از الگوها را بررسی کنید
برای کدهای این دوره تاکنون از قالب های Empty Activity و Basic Activity برای شروع پروژه های جدید استفاده کرده اید. شما همچنین می توانید از الگوهای فعالیت در هنگام ایجاد فعالیت ها پس از ایجاد پروژه خود استفاده کنید.
- یک پروژه برنامه ایجاد کنید یا یک پروژه موجود را انتخاب کنید.
- در قسمت Project > Android ، روی پوشه java راست کلیک کنید.
- جدید > فعالیت > گالری را انتخاب کنید.
- با انتخاب یکی از الگوهای
Activity
، یک فعالیت به برنامه اضافه کنید. به عنوان مثال، Navigation Drawer Activity را انتخاب کنید تاActivity
را که دارای کشوی ناوبری است اضافه کنید. - برای نمایش اکتیویتی در ویرایشگر طرح بندی، روی فایل طرح بندی اکتیویتی (مثلا
activity_main2.xml
) دوبار کلیک کنید. برای جابهجایی بین پیشنمایش طرحبندی فعالیت و کد طرحبندی، از تب Design و برگه متن استفاده کنید.
مخازن Google Samples در GitHub نمونههای کد اندروید Kotlin را ارائه میکنند که میتوانید آنها را مطالعه، کپی و در پروژههای خود بگنجانید.
مرحله 1: یک نمونه کد Kotlin اندروید را دانلود و اجرا کنید
- در یک مرورگر، به github.com/googlesamples بروید.
- برای زبان ، Kotlin را انتخاب کنید.
- یک برنامه نمونه اندروید Kotlin که اخیراً اصلاح شده است را انتخاب کنید و کد پروژه برنامه را دانلود کنید. برای این مثال، فایل زیپ را برای برنامه android-sunflower دانلود کنید که برخی از اجزای Android Jetpack را نشان می دهد.
- در Android Studio پروژه android-sunflower-master را باز کنید.
- بهروزرسانیهایی را که Android Studio توصیه میکند بپذیرید، سپس برنامه را روی شبیهساز یا دستگاه مجهز به Android اجرا کنید.
مرحله 2: نمونه کد اندروید Kotlin را کاوش کنید
اکنون که نمونه برنامه Android Sunflower را در اندروید استودیو باز کرده اید، با این برنامه آشنا شوید و فایل های پروژه آن را بررسی کنید.
- برای اطلاعات در مورد آنچه که یک برنامه نمونه نشان می دهد، از فایل README برنامه در GitHub دیدن کنید. برای این مثال، Android Sunflower README را ببینید.
- در Android Studio، یکی از فایلهای فعالیت Kotlin را در برنامه باز کنید، برای مثال
GardenActivity.kt
. - در
GardenActivity.kt
، کلاس، نوع یا رویهای را پیدا کنید که با آن آشنا نیستید و آن را در مستندات برنامهنویس Android جستجو کنید. به عنوان مثال، برای کسب اطلاعات بیشتر در مورد متدsetContentView()
، در developer.android.com جستجو کنید تاsetContentView()
پیدا کنید.
مرحله 3: نماد راهانداز را تغییر دهید
در این مرحله شما آیکون لانچر اپلیکیشن نمونه اندروید آفتابگردان را تغییر می دهید. شما یک تصویر کلیپ آرت اضافه میکنید و از آن برای جایگزینی نماد راهانداز فعلی Android Sunflower استفاده میکنید.
نمادهای لانچر
هر برنامهای که با Android Studio ایجاد میکنید با یک نماد راهانداز پیشفرض شروع میشود که نشاندهنده برنامه است. نمادهای راهانداز گاهی اوقات نماد برنامه یا نماد محصول نامیده میشوند.
اگر برنامهای را در Google Play منتشر کنید، نماد راهانداز برنامه در فهرست برنامه و نتایج جستجو در فروشگاه Google Play ظاهر میشود.
پس از نصب برنامه بر روی دستگاه مجهز به اندروید، نماد راهانداز برنامه در صفحه اصلی دستگاه و در جاهای دیگر دستگاه ظاهر میشود. به عنوان مثال، نماد راهانداز برنامه Android Sunflower در پنجره برنامههای جستجوی دستگاه ظاهر میشود که به صورت 1 در تصویر زیر نشان داده شده است. نماد راهانداز پیشفرض، که در زیر نشان داده شده است، در ابتدا برای همه پروژههای برنامهای که در Android Studio ایجاد میکنید استفاده میشود.
تغییر نماد راهانداز
گذراندن مراحل تغییر آیکون لانچر شما را با ویژگی های دارایی تصویر اندروید استودیو آشنا می کند.
در Android Studio، در اینجا نحوه تغییر نماد راهانداز برنامه Android Sunflower آورده شده است:
- در قسمت Project > Android ، روی پوشه res راست کلیک کنید (یا Control+click). New > Image Asset را انتخاب کنید. کادر گفتگوی پیکربندی دارایی تصویر ظاهر می شود.
- در قسمت Icon Type ، اگر قبلاً انتخاب نشده است ، Launcher Icons (Adaptive & Legacy) را انتخاب کنید. روی تب Foreground Layer کلیک کنید.
- برای نوع دارایی ، Clip Art را انتخاب کنید، که به صورت 1 در تصویر زیر نشان داده شده است.
- روی نماد ربات در قسمت Clip Art کلیک کنید، که به صورت 2 در تصویر بالا نشان داده شده است. کادر محاوره ای Select Icon ظاهر می شود که مجموعه آیکون Design Design را نشان می دهد.
- گفتگوی انتخاب نماد را مرور کنید یا نمادی را با نام جستجو کنید. یک نماد، مانند نماد خلق و خو را برای نشان دادن حالت خوب انتخاب کنید. روی OK کلیک کنید.
- در گفتگوی پیکربندی دارایی تصویر ، روی تب Background Layer کلیک کنید. برای نوع دارایی ، رنگ را انتخاب کنید. روی تراشه رنگ کلیک کنید و رنگی را برای استفاده به عنوان لایه پسزمینه برای نماد انتخاب کنید.
- روی برگه Legacy کلیک کنید و تنظیمات پیش فرض را مرور کنید. تأیید کنید که میخواهید نمادهای قدیمی، گرد و فروشگاه Google Play ایجاد کنید. روی Next کلیک کنید.
- کادر گفتگوی Confirm Icon Path ظاهر میشود که نشان میدهد فایلهای نماد در کجا اضافه شده و رونویسی میشوند. روی Finish کلیک کنید.
- برنامه را روی شبیه ساز AVD یا دستگاه مجهز به اندروید اجرا کنید.
Android Studio به طور خودکار تصاویر راهانداز را به فهرستهای mipmap برای تراکمهای مختلف صفحه اضافه میکند. برنامه Android Sunflower اکنون از نماد جدید کلیپ آرت به عنوان نماد راه اندازی خود استفاده می کند.
- دوباره برنامه را اجرا کنید. مطمئن شوید که نماد راهانداز جدید در صفحه برنامههای جستجو ظاهر میشود.
مرحله 1: اسناد رسمی اندروید را کاوش کنید
چند مورد از مفیدترین سایتهای اسناد Android را کاوش کنید و با موارد موجود آشنا شوید:
- به developer.android.com بروید. این اسناد رسمی برنامهنویس اندروید توسط Google بهروز نگه داشته میشود.
- به developer.android.com/design/ بروید. این سایت دستورالعمل هایی را برای طراحی ظاهر و عملکرد اپلیکیشن های اندروید با کیفیت بالا ارائه می دهد.
- به material.io بروید، که سایتی در مورد طراحی متریال است. طراحی متریال یک فلسفه طراحی مفهومی است که نشان می دهد همه برنامه ها، نه فقط برنامه های اندروید، چگونه باید در دستگاه های تلفن همراه ظاهر و کار کنند. برای کسب اطلاعات بیشتر در مورد طراحی متریال، پیوندها را دنبال کنید. برای مثال، برای آشنایی با استفاده از رنگ، روی تب Design کلیک کنید، سپس Color را انتخاب کنید.
- به developer.android.com/docs/ بروید تا اطلاعات API، اسناد مرجع، آموزشها، راهنماهای ابزار و نمونههای کد را بیابید.
- برای یافتن اطلاعات درباره انتشار یک برنامه در Google Play به developer.android.com/distribute/ بروید. Google Play سیستم توزیع دیجیتال گوگل برای برنامه های توسعه یافته با Android SDK است. از کنسول Google Play استفاده کنید تا پایگاه کاربری خود را افزایش دهید و شروع به کسب درآمد کنید.
مرحله 2: محتوای تیم Android و جستجوی Google را کاوش کنید
- کانال YouTube Developer Android را کاوش کنید، که منبع عالی از آموزش ها و نکات است.
- از وبلاگ رسمی Android بازدید کنید، جایی که تیم Android اخبار و نکات را پست می کند.
- سوالی را در جستجوی گوگل وارد کنید و موتور جستجوی گوگل نتایج مرتبط را از منابع مختلف جمع آوری می کند. به عنوان مثال، از جستجوی گوگل برای پرسیدن این سوال استفاده کنید: "محبوب ترین نسخه سیستم عامل اندروید در هند چیست؟" حتی می توانید پیام های خطا را در جستجوی گوگل وارد کنید.
مرحله 3: در Stack Overflow جستجو کنید
Stack Overflow جامعه ای از برنامه نویسانی است که به یکدیگر کمک می کنند. اگر با مشکلی مواجه شدید، احتمال اینکه شخصی قبلاً پاسخی را ارسال کرده باشد، زیاد است.
- به Stack Overflow بروید.
- در کادر جستجو، سوالی مانند "چگونه ADB را از طریق Wi-Fi تنظیم و استفاده کنم؟" را وارد کنید. شما می توانید بدون ثبت نام در Stack Overflow جستجو کنید، اما اگر می خواهید یک سوال جدید ارسال کنید یا به یک سوال پاسخ دهید، باید ثبت نام کنید.
- در کادر جستجو،
[android]
را وارد کنید. براکتهای[]
نشان میدهند که میخواهید پستهایی را جستجو کنید که در مورد Android برچسبگذاری شدهاند. - می توانید برچسب ها و عبارات جستجو را ترکیب کنید تا جستجوی خود را خاص تر کنید. این جستجوها را امتحان کنید:
-
[android] and [layout]
-
[android] "hello world"
مرحله 4: از مدیر SDK برای نصب اسناد آفلاین استفاده کنید
هنگامی که Android Studio را نصب می کنید، اجزای ضروری Android SDK به همراه آن نصب می شوند. برای نصب سایر کتابخانه ها و اسناد موجود، از مدیر SDK استفاده کنید.
برای کاوش مدیر SDK و دانلود اسناد SDK، این مراحل را دنبال کنید:
- در Android Studio، Tools > SDK Manager را انتخاب کنید. مدیر SDK باز می شود.
- در ستون سمت چپ مدیر SDK، Android SDK را انتخاب کنید (1 در تصویر زیر).
- به مسیر موجود در قسمت Android SDK Location (2 در تصویر زیر) توجه کنید. بعداً از این مسیر استفاده می کنید تا هر آنچه را که نصب می کنید پیدا کنید.
- در SDK Manager، روی تب Platforms SDK کلیک کنید. از اینجا می توانید نسخه های بیشتری از سیستم اندروید را نصب کنید.
- روی تب ابزار SDK کلیک کنید. از اینجا می توانید ابزارهای توسعه دهنده SDK را نصب کنید که به طور پیش فرض نصب نشده اند. همچنین میتوانید نسخه آفلاین اسناد توسعهدهنده اندروید را نصب کنید.
- روی برگه سایتهای بهروزرسانی SDK کلیک کنید. Android Studio سایت های فهرست شده و انتخاب شده را به طور منظم برای به روز رسانی بررسی می کند.
- به تب ابزار SDK برگردید و چک باکس Documentation for Android SDK را انتخاب کنید، اگر قبلاً انتخاب نشده است. روی Apply کلیک کنید.
یک گفتگوی تأیید باز می شود که به شما نشان می دهد که دانلود به چه مقدار فضای دیسک نیاز دارد. روی OK کلیک کنید. - پس از اتمام نصب، روی Finish کلیک کنید.
برای یافتن اسنادی که نصب کرده اید، این مراحل را دنبال کنید:
- در رایانه خود، به فهرست راهنمای
Android/sdk/
بروید. (برای یافتن مسیر دایرکتوری، به قسمت مکان SDK Android ، که به صورت 2 در تصویر بالا نشان داده شده است، مراجعه کنید.) - دایرکتوری
docs/
را باز کنید. - فایل
index.html
را پیدا کرده و در مرورگر باز کنید.
- اسناد رسمی برنامه نویس اندروید در developer.android.com است.
- طراحی متریال یک فلسفه طراحی مفهومی است که نشان می دهد برنامه ها چگونه باید در دستگاه های تلفن همراه ظاهر و کار کنند. طراحی متریال فقط برای برنامه های اندروید نیست. دستورالعملهای طراحی مواد در material.io هستند.
- Android Studio الگوهایی را برای طراحی برنامهها و فعالیتهای رایج و پیشنهادی ارائه میکند. این الگوها کد کاری را برای موارد استفاده رایج ارائه می دهند.
- هنگامی که یک پروژه ایجاد می کنید، می توانید یک الگو برای اولین فعالیت خود انتخاب کنید.
- در حالی که در حال توسعه برنامه خود هستید، می توانید فعالیت ها و سایر اجزای برنامه را از قالب های داخلی ایجاد کنید.
- Google Samples شامل نمونه کدهایی است که می توانید آن ها را مطالعه، کپی و در پروژه های خود بگنجانید.
دوره بی ادبی:
مستندات اندروید استودیو:
مستندات توسعه دهنده اندروید:
- سایت توسعه دهنده اندروید
- سایت آموزش توسعه دهندگان گوگل
- طرح بندی ها
- مروری بر منابع برنامه
- منوها
-
TextView
- منابع رشته ای
- نمای کلی برنامه
نمونه کد:
- کد منبع دوره های آموزشی Google Developers در GitHub
- نمونه های گوگل
- نمونه کد اندروید برای توسعه دهندگان
ویدئوها:
سایر منابع:
درس بعدی را شروع کنید:
برای پیوند به سایر کدهای این دوره، به صفحه فرود کد لبههای کد پایه Android Kotlin Fundamentals مراجعه کنید.