Hướng dẫn cài đặt sdk android

Question

là thư viện bản đồ vector cho Android. Hướng dẫn này sẽ hướng dẫn bạn cài đặt vietbando Android SDK với Android Studio, tải bản đồ, cấm 1 điểm lên nó, và thay đổi kiểu bản đồ.

Nội dung chính Show

Cài đặt Android Studio
Cài đặt Android Virtual Device
Cài đặt Vietbando
Cấp quyền ứng dụng
Access tokens
Tạo App.java
Thêm bản đồ
Cấu hình MapView của bạn
Thay đổi kiểu bản đồ
Dự án mẫu

Lưu ý! Chúng tôi vẫn đang tích cực phát triển Vietbando Android SDK và sẽ cập nhật hướng dẫn này và hướng dẫn mới khi cải thiện các tính năng tuyệt vời của nó.

Cài đặt Android Studio

Mở Android Studio và vào File ‣ New ‣ New Project để tạo một dự án mới (hoặc chọn Start a new Android Studio project). Định cấu hình dự án mới của bạn::

Đặt tên dự án là <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> 3
Thiết lập tên miền <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> 4

Dưới Select the form factors your app will run on, chọn “Phone and Tablet.” Để có bộ SDK tối giản,

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
<uses-permission android:name="android.permission.INTERNET" />  
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />  
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

5. Đây là cấp API thấp nhất đang được hỗ trợ bởi vietbando Android SDK.

Nhấn Next để đến màn hình lựa chọn Activity. Chọn Empty Activity and chọn Next. Chấp nhận mặc định

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
<uses-permission android:name="android.permission.INTERNET" />  
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />  
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

6 and

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
<uses-permission android:name="android.permission.INTERNET" />  
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />  
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

7 and chọn Finish.

Cài đặt Android Virtual Device

Android Studio có thể giúp bạn thiết lập các thiết bị Android ảo trên máy tính của bạn để giúp thử nghiệm ứng dụng của bạn trong khi bạn phát triển. Để thiết lập một thiết bị bạn chọn biểu tượng Android Virtual Device (AVD) Manager

, và chọn nút Create Virtual Device . Tại danh mục Phones, chọn Nexus 5 and chọn Next. Chọn phiên bản bạn muốn kiểm tra (hướng dẫn này được xây dựng bằng Lollipop API level 23, x86, Android 6.0). Tìm hiểu thêm về cách thiết lập AVD từ Android Studio’s documentation.

Cài đặt Vietbando

Tải Vietbando SDK về tại đây. Giao diện bắt đầu cài đặt thư viện sẽ tuần tự theo thứ tự như sau:

Để sủ dụng Android SDK, thêm dòng Module Build File

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
<uses-permission android:name="android.permission.INTERNET" />  
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />  
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

8 này vào:

repositories {  
    mavenCentral()  
}
dependencies {  
    implementation fileTree(dir: 'libs', include: ['*.jar'])  
    implementation 'com.android.support:multidex:1.0.3'  
    implementation 'androidx.appcompat:appcompat:1.5.1'    
    // add the vietbando SDK dependency below  
    implementation project(':VietbandoGLAndroidSDK-release')  
    implementation 'com.jakewharton.timber:timber:4.7.1'  
     implementation'com.squareup.okhttp3:okhttp:4.9.1'  
    implementation'com.google.code.gson:gson:2.8.9'  
}

Cấp quyền ứng dụng

Đảm bảo các quyền core sau đây được yêu cầu trong file

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
<uses-permission android:name="android.permission.INTERNET" />  
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />  
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

9 từ dự án

<resources>  
    <string name="app_name">Example</string>  
    <string name="accessToken">khóa xác thực của bạn</string>  
</resources>

0:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
<uses-permission android:name="android.permission.INTERNET" />  
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />  
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

Access tokens

Để dùng dịch vụ vietbando và API, chẳng hạn như bản đồ, mã địa lý, bạn phải có một Khóa xác thực vietbando. Bạn có thể tìm thấy Khóa xác thực của bạn trong cài đặt tài khoản của bạn, nơi bạn có thể lấy thẻ hiện tại và tạo ra những cái mới. Khóa xác thực giúp bạn theo dõi việc sử dụng và giảm thiểu sự gián đoạn trong trường hợp một mã thông báo cần phải được thu hồi.

Đầu tiên, vào cài đặt tài khoản của bạn và tạo ra một Khóa xác thực mới cho

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
<uses-permission android:name="android.permission.INTERNET" />  
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />  
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

3.

Xem hướng dẫn chi tiết đăng kí khóa xác thực

Một khi bạn đãcó thẻ, mở file

<resources>  
    <string name="app_name">Example</string>  
    <string name="accessToken">khóa xác thực của bạn</string>  
</resources>

2 từ

<resources>  
    <string name="app_name">Example</string>  
    <string name="accessToken">khóa xác thực của bạn</string>  
</resources>

3.

Thêm một chuỗi mới cho mã thông báo truy cập của bạn:

<resources>  
    <string name="app_name">Example</string>  
    <string name="accessToken">khóa xác thực của bạn</string>  
</resources>

Tạo App.java

Tạo

<resources>  
    <string name="app_name">Example</string>  
    <string name="accessToken">khóa xác thực của bạn</string>  
</resources>

4 extend

<resources>  
    <string name="app_name">Example</string>  
    <string name="accessToken">khóa xác thực của bạn</string>  
</resources>

5 class. Trong Hàm

<resources>  
    <string name="app_name">Example</string>  
    <string name="accessToken">khóa xác thực của bạn</string>  
</resources>

6 thêm dòng

<resources>  
    <string name="app_name">Example</string>  
    <string name="accessToken">khóa xác thực của bạn</string>  
</resources>

7

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

File

<resources>  
    <string name="app_name">Example</string>  
    <string name="accessToken">khóa xác thực của bạn</string>  
</resources>

4 tạo xong phải có dòng này trong

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
<uses-permission android:name="android.permission.INTERNET" />  
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />  
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

9:

<application android:name=".App"...>...</application>

MapView

Lớp

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

0 là thành phần chính của thư viện. Nó hoạt động giống như các View khác và hành vi của nó có thể được thay đổi tĩnh với một file XML layout, hoặc lập trình tại runtime.

Để thêm các

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

0 như một yếu tố layout, thay thế mã trong file

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

2 từ

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

3 với đoạn mã sau::

<?xml version="1.0" encoding="utf-8"?>  
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"  
    xmlns:tools="http://schemas.android.com/tools"  
    xmlns:vietbando="http://schemas.android.com/apk/res-auto"  
    android:layout_width="match_parent"  
    android:layout_height="match_parent"  
    tools:context=".MainActivity">
    <com.vietbando.vietbandosdk.maps.MapView  
        android:id="@+id/mapview"  
        android:layout_width="fill_parent"  
        android:layout_height="fill_parent"  
        vietbando:access_token="@string/accessToken"/>  
        <!-- note the access token string created in the previous step -->  
</RelativeLayout>

Sau đó, bạn có thể gọi lớp

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

0 được lập trình bên trong Activity:

findViewById(R.id.mapview);

Thêm bản đồ

Trong Android Studio và chuyển đến

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

5.

Chúng ta sẽ sử dụng

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

6 chúng ta thiết lập trước đó để thêm một bản đồ vietbando vào ứng dụng của chúng ta. Ứng dụng cần phải biết khi nào để thêm bản đồ, chằng hạn khi activity được khởi tạo với

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

7.

private MapView mapView;
    @Override  
    protected void onCreate(Bundle savedInstanceState) {  
        super.onCreate(savedInstanceState);  
        setContentView(R.layout.activity_main);
        // Create a mapView  
        mapView = (MapView) findViewById(R.id.mapview);  
        mapView.onCreate(savedInstanceState);  
    }

Tiếp theo, sử dụng lớp

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

6 mới của bạn để tạo ra một đối tượng

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

9.

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

9có rất nhiều phương pháp trong đó sẽ cho phép bạn áp dụng các style, thay đổi vị trí camera, thêm marker, và nhiều hơn nữa. Tạo

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

9 của bạn:

mapView.getMapAsync(new OnMapReadyCallback() {  
    @Override  
    public void onMapReady(vietbandoMap vietbandoMap) {  
    // Customize map with markers, polylines, etc.  
    }  
});

Cấu hình MapView của bạn

Bắt đầu với phiên bản 4.0.0 của vietbando Android SDK, bạn có thể cấu hình nhiều đặc điểm của bản đồ của bạn, bao gồm cả vị trí bắt đầu camera, URL style, và Khóa xác thực, trong file layout của bạn. Thêm mục sau vào file layout của bạn, bên trong tag

<application android:name=".App"...>...</application>

2:

  
vietbando:center_latitude="10.7773973"  
vietbando:center_longitude="106.701278"  
vietbando:zoom="12"  
vietbando:tilt="20"

Khi bạn đã hoàn tất nhập mã ở trên, có thể bạn sẽ thấy một số văn bản cảnh báo màu đỏ từ Android Studio. Điều này là do chúng ta chưa import một số các lớp được tham chiếu trong

<application android:name=".App"...>...</application>

3. Bạn có thể tự động nhập các lớp này bằng cách nhấn Alt + Enter (option + return trên Mac). Ngoài ra, tay thêm dòng sau vào phần đầu của file

<application android:name=".App"...>...</application>

3:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
<uses-permission android:name="android.permission.INTERNET" />  
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />  
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

0

Tiếp theo, chúng ta sẽ xử lý các loại khác của các sự kiện có thể ảnh hưởng đến ứng dụng bản đồ của chúng ta:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
<uses-permission android:name="android.permission.INTERNET" />  
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />  
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

1

Nhấp vào nút Run ‘app’

để build ứng dụng. Android Studio sẽ mất một vài giây để xây dựng và nếu nó kết thúc mà không có lỗi, bạn sẽ có thể test nó trong AVD bạn thiết lập trước đó.

Thay đổi kiểu bản đồ

Các vietbando Android SDK đi kèm với một số các , vì vậy hãy thử thay đổi nó một chút.

Gợi ý: Hãy thử gõ

<application android:name=".App"...>...</application>

5 và Android Studio sẽ cung cấp cho bạn một danh sách các kiểu có sẵn để lựa chọn.

Bên trong

<resources>  
    <string name="app_name">Example</string>  
    <string name="accessToken">khóa xác thực của bạn</string>  
</resources>

6, thay đổi để gán

  
    package com.vbd.example.mapsdkexample;
    import androidx.multidex.MultiDex;  
    import androidx.multidex.MultiDexApplication;
    import com.vietbando.vietbandosdk.Vietbando;
    public class App extends MultiDexApplication {
        @Override  
        public void onCreate() {  
            super.onCreate();  
            MultiDex.install(this);  
            Vietbando.getInstance(getApplicationContext(), getString(R.string.access_token));  
        }
    }

9style thành:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
<uses-permission android:name="android.permission.INTERNET" />  
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />  
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

2