شروع کنید

با ادغام Navigation SDK برای Android، برنامه شما می تواند فراتر از پیوند دادن به نمای نقشه خارجی باشد. با ناوبری Google Maps، برنامه شما می‌تواند بازیابی پویا و گزارش تک‌نگاهی داده‌های سفر راننده را ارائه دهد.

این راهنما به شما یک پروژه Android Studio را نشان می‌دهد، چگونه می‌توانید Navigation SDK را ادغام کنید و برنامه آزمایشی ارائه شده با SDK را اجرا کنید.

Navigation SDK یک کتابخانه ثابت (.aar) است که به شما امکان کنترل ظاهر و صدا را برای پیمایش در برنامه می دهد. برای جزئیات در مورد کتابخانه، مرجع SDK ناوبری (Javadoc) را در یک پنجره جداگانه باز کنید.

آماده شدن

برای شروع کار با Navigation SDK برای اندروید، حتما موارد زیر را داشته باشید:

• نماینده پلتفرم Google Maps برای دسترسی به موارد زیر:

  • یک کلید API که برای استفاده با Navigation SDK ارائه شده است. شما باید ID پروژه خود را که می توانید در داشبورد اصلی Google Cloud Console پیدا کنید، تحت نام پروژه ارائه دهید.

  • فایل فشرده که شامل:

    • فایل کتابخانه ایستا .aar در دایرکتوری libs/ حاوی Navigation SDK به عنوان یک بسته aar .
    • فایل های متنی برای صدور مجوز و پیوندهایی به شرایط استفاده و توافق نامه ها.
    • یک برنامه آزمایشی برای وارد کردن به عنوان یک پروژه جدید در Android Studio. فایل های برنامه برای ساختن برنامه دمو در اندروید استودیو با استفاده از Gradle و Maven.

• Android Studio ، محیط توسعه توصیه شده برای ساخت برنامه با Navigation SDK. این مستندات برای افرادی که با توسعه اندروید و مفاهیم برنامه نویسی شی گرا آشنا هستند طراحی شده است. همچنین باید از نظر کاربر با نقشه های گوگل آشنا باشید.

SDK، برنامه آزمایشی و اسناد را دریافت کنید

بعد از اینکه فایل SDK را دانلود و از حالت فشرده خارج کردید، می توانید برنامه دمو را بررسی و اجرا کنید.

برنامه آزمایشی ساختی را ارائه می دهد که یک کلاس NavigationFragment و یک نسخه را پیاده سازی می کند که یک کلاس NavigationView را پیاده سازی می کند. نوع NavigationFragment به طور پیش فرض اجرا می شود و یک مسیر ناوبری را همانطور که در تصویر زیر نشان داده شده است نمایش می دهد.

1. با استفاده از مدیر فایل مورد علاقه خود، به دایرکتوری با فایل های SDK بروید.

2. کتابخانه Navigation SDK را در فهرست app/libs پروژه demo کپی کنید:

   برای مثال، ممکن است cp libs/*.aar demo/app/libs در ترمینال لینوکس خود اجرا کنید.

3. در Android Studio ، برنامه آزمایشی را وارد کنید و اجازه دهید Gradle اجرا شود.

   توجه: تا زمانی که مانیفست برنامه را با کلید API ارائه شده به‌روزرسانی نکنید، ساخت برنامه با شکست مواجه می‌شود.

4. AndroidManifest.xml برنامه را باز کنید و مقدار ویژگی API_KEY را به‌روزرسانی کنید:

   <?xml version="1.0" encoding="utf-8"?>
   <manifest xmlns:android="http://schemas.android.com/apk/res/android"
       package="com.example.navigationapidemo" >
   
       <application
           android:allowBackup="true"
           android:icon="@mipmap/ic_launcher"
           android:label="@string/app_name"
           android:supportsRtl="true"
           android:theme="@style/_AppTheme" >
   
           <meta-data
               android:name="com.google.android.geo.API_KEY"
               android:value="YOUR_API_KEY"/>
       </application>
   </manifest>
   

5. روی build کلیک کنید و جزئیات پیاده سازی SDK را بررسی کنید.

   • در کلاس جاوا، کد پیاده سازی را یادداشت کنید.

   • در layout xml به طرح و متن طرح بندی توجه کنید.

   • در فایل build.gradle، SDK را در وابستگی ها یادداشت کنید.

برنامه را اجرا کنید

1. یک دستگاه Android را به رایانه خود وصل کنید یا از یک شبیه ساز استفاده کنید.

   • دستگاه Android به دستورالعمل‌ها مراجعه کنید تا گزینه‌های برنامه‌نویس را در دستگاه Android خود فعال کنید و سیستم خود را برای شناسایی دستگاه پیکربندی کنید.
   • شبیه ساز از مدیر دستگاه مجازی اندروید (AVD) برای پیکربندی یک دستگاه مجازی استفاده کنید. هنگام انتخاب یک شبیه ساز، مطمئن شوید که تصویری را انتخاب کرده اید که شامل API های Google باشد.

2. در اندروید استودیو ، روی گزینه منوی اجرا (یا نماد دکمه پخش) کلیک کنید. و سپس، یک هدف استقرار را انتخاب کنید.

3. در برنامه نمایشی پیمایش ، تنظیم مقصد را انتخاب کنید، سپس برای انتخاب مکان و شروع پیمایش شبیه‌سازی شده، فرمان‌ها را دنبال کنید.

نوع View را بسازید

برنامه آزمایشی شامل یک نوع View است.

1. در اندروید استودیو ، برنامه آزمایشی را باز کنید و روی تب Build Variants در پنجره Build کلیک کنید.

   توجه: تب Variant به صورت عمودی در سمت چپ پنجره Build ظاهر می شود.

2. در پنجره Build Variants ، viewDebug را انتخاب کنید و لیست فایل ها تغییر می کند.

3. جزئیات پیاده سازی SDK را برای کلاس NavigationView بررسی کنید.

   • در NavViewActivity.java ، کد پیاده سازی را یادداشت کنید.

   • در Activity_Nav_View.xml ، به طراحی طرح‌بندی و متن توجه کنید.

4. برنامه را بسازید و اجرا کنید. نام برنامه تغییر می کند تا نشان دهد کدام نسخه ساخته شده است. در غیر این صورت، فقط شی رندر متفاوت است.

گام بعدی

Navigation SDK برای اندروید را در برنامه خود ادغام کنید .