Руководство по миграции пакета SDK для Android Карты Azure
Перенос из пакета SDK для Android Карты Azure в веб-пакет SDK в WebView включает переход существующего представления карты из собственной реализации в веб-карту с помощью веб-пакета SDK Карты Azure. В этом руководстве показано, как перенести код и компоненты из пакета SDK Для Android в веб-пакет SDK.
Примечание.
Прекращение использования пакета SDK для Android для Azure Карты
Пакет SDK для машинного кода Azure для Android Карты теперь устарел и будет прекращен 3.31.25. Чтобы избежать сбоев в работе служб, перейдите в веб-пакет SDK для Azure Карты на 3.31.25.
Необходимые компоненты
Для использования Map Control на веб-странице необходимо выполнить одно из указанных ниже предварительных требований.
- Учетная запись Azure Maps.
- Ключ подписки или учетные данные Microsoft Entra. Дополнительные сведения см. в разделе "Параметры проверки подлинности".
Создание WebView
Добавьте WebView, если приложение Android не имеет его. Для этого добавьте WebView элемент в XML макета или программно в коде Java. Убедитесь, что оно настроено на оккупацию требуемой области макета.
<?xml version="1.0" encoding="utf-8"?>
<androidx.coordinatorlayout.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<WebView
android:id="@+id/webView"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
</androidx.coordinatorlayout.widget.CoordinatorLayout>
Включите доступ к Интернету, добавив разрешения в AndroidManifest.xml.
<uses-permission android:name="android.permission.INTERNET" />
В действии или фрагменте инициализируйте WebView и включите JavaScript, обновив параметры. Загрузите HTML-файл, содержащий код веб-пакета SDK. Его можно загрузить из папки ресурсов или из удаленный URL-адрес.
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import android.webkit.WebSettings;
import android.webkit.WebView;
public class MainActivity extends AppCompatActivity {
private WebView webView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
webView = findViewById(R.id.webView);
// Enable JavaScript
WebSettings webSettings = webView.getSettings();
webSettings.setJavaScriptEnabled(true);
// Load local HTML file from /src/main/assets/map.html
webView.loadUrl("file:///android_asset/map.html");
}
}
Настройка карты с помощью веб-пакета SDK для Azure Карты
В HTML-файле инициализируйте карту с ключом подписки. Замените <YOUR_SUBSCRIPTION_KEY> фактическим ключом.
<!DOCTYPE html>
<html>
<head>
<title>Azure Maps</title>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<!-- Add references to the Azure Maps Map control JavaScript and CSS files. -->
<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.css" type="text/css"/>
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.js"></script>
<style>
html,
body,
#map {
margin: 0;
height: 100%;
width: 100%;
}
body {
display: flex;
flex-direction: column;
}
main {
flex: 1 1 auto;
}
</style>
<script type="text/javascript">
// Create an instance of the map control.
function InitMap() {
var map = new atlas.Map("map", {
center: [-122.33, 47.6],
zoom: 12,
authOptions: {
authType: "subscriptionKey",
subscriptionKey: "<YOUR_SUBSCRIPTION_KEY>"
}
});
// Wait until the map resources are ready.
map.events.add("ready", function () {
// Resize the map to fill the container.
map.resize();
});
}
</script>
</head>
<body onload="InitMap()">
<main>
<div id="map"></div>
</main>
</body>
</html>
Сохраните и запустите приложение. Карта появится в WebView. Добавьте все необходимые функции или функции из веб-пакета SDK. Дополнительные сведения см. в документации по Azure Карты и примерах Карты Azure.
Обмен данными между машинным кодом и WebView (необязательно)
Чтобы включить обмен данными между приложением Android и WebView, можно использовать метод WebView addJavascriptInterface для предоставления объекта Java JavaScript, работающего в WebView. Он позволяет вызывать методы Java из кода JavaScript. Дополнительные сведения см . в документации по Android WebView .
Очистка собственной реализации карты
Удалите код, связанный с собственным пакетом SDK для Azure Карты Android, включая зависимости и код инициализации, связанные с com.azure.android:azure-maps-control.
Тестирование
Тщательно протестируйте приложение, чтобы убедиться, что миграция выполнена успешно. Проверьте наличие проблем, связанных с функциональными возможностями карты, взаимодействием пользователей и производительностью.
Следующие шаги
Узнайте, как добавлять карты в веб-приложения и мобильные приложения с помощью клиентской библиотеки JavaScript на стороне клиента Map Control в Azure Карты: