Snabbstart: Skapa en Android-app med Azure Kartor

I filen MainActivity.java måste du:

• lägga till importer för Azure Kartor SDK
• ange autentiseringsinformation Kartor Azure-server
• hämta kartkontrollinstansen i metoden onCreate

Om du anger autentiseringsinformationen för klassen globalt med metoderna eller blir den så att du inte behöver lägga till AzureMaps setSubscriptionKey setAadProperties autentiseringsinformation i varje vy.

Kartkontrollen innehåller sina egna livscykelmetoder för att hantera Androids OpenGL-livscykel. Dessa livscykelmetoder måste anropas direkt från den innehållande aktiviteten. För att appen ska kunna anropa kartkontrollens livscykelmetoder korrekt måste du åsidosätta följande livscykelmetoder i den aktivitet som innehåller kartkontrollen. Och du måste anropa respektive kartkontrollmetod.

• onCreate(Bundle)
• onDestroy()
• onLowMemory()
• onPause()
• onResume()
• onSaveInstanceState(Bundle)
• onStart()
• onStop()

Redigera filen MainActivity.java på följande sätt:

package com.example.myapplication;

import androidx.appcompat.app.AppCompatActivity;
import com.azure.android.maps.control.AzureMaps;
import com.azure.android.maps.control.MapControl;
import com.azure.android.maps.control.layer.SymbolLayer;
import com.azure.android.maps.control.options.MapStyle;
import com.azure.android.maps.control.source.DataSource;

public class MainActivity extends AppCompatActivity {

static {
    AzureMaps.setSubscriptionKey("<Your Azure Maps subscription key>");

    //Alternatively use Azure Active Directory authenticate.
    //AzureMaps.setAadProperties("<Your aad clientId>", "<Your aad AppId>", "<Your aad Tenant>");
}

MapControl mapControl;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    mapControl = findViewById(R.id.mapcontrol);

    mapControl.onCreate(savedInstanceState);

    //Wait until the map resources are ready.
    mapControl.onReady(map -> {
        //Add your post map load code here.

    });
}

@Override
public void onResume() {
    super.onResume();
    mapControl.onResume();
}

@Override
protected void onStart(){
    super.onStart();
    mapControl.onStart();
}

@Override
public void onPause() {
    super.onPause();
    mapControl.onPause();
}

@Override
public void onStop() {
    super.onStop();
    mapControl.onStop();
}

@Override
public void onLowMemory() {
    super.onLowMemory();
    mapControl.onLowMemory();
}

@Override
protected void onDestroy() {
    super.onDestroy();
    mapControl.onDestroy();
}

@Override
protected void onSaveInstanceState(Bundle outState) {
    super.onSaveInstanceState(outState);
    mapControl.onSaveInstanceState(outState);
}}

I filen MainActivity.kt måste du:

• lägga till importer för Azure Kartor SDK
• ange autentiseringsinformation Kartor Azure-server
• hämta kartkontrollinstansen i metoden onCreate

Om du anger autentiseringsinformationen för klassen globalt med metoderna eller blir den så att du inte behöver lägga till AzureMaps setSubscriptionKey setAadProperties autentiseringsinformation i varje vy.

Kartkontrollen innehåller sina egna livscykelmetoder för att hantera Androids OpenGL-livscykel. Dessa livscykelmetoder måste anropas direkt från den innehållande aktiviteten. För att appen ska kunna anropa kartkontrollens livscykelmetoder korrekt måste du åsidosätta följande livscykelmetoder i den aktivitet som innehåller kartkontrollen. Och du måste anropa respektive kartkontrollmetod.

• onCreate(Bundle)
• onDestroy()
• onLowMemory()
• onPause()
• onResume()
• onSaveInstanceState(Bundle)
• onStart()
• onStop()

Redigera filen MainActivity.kt på följande sätt:

package com.example.myapplication;

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import com.azure.android.maps.control.AzureMap
import com.azure.android.maps.control.AzureMaps
import com.azure.android.maps.control.MapControl
import com.azure.android.maps.control.events.OnReady

class MainActivity : AppCompatActivity() {

    companion object {
        init {
            AzureMaps.setSubscriptionKey("<Your Azure Maps subscription key>");

            //Alternatively use Azure Active Directory authenticate.
            //AzureMaps.setAadProperties("<Your aad clientId>", "<Your aad AppId>", "<Your aad Tenant>");
        }
    }

    var mapControl: MapControl? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        mapControl = findViewById(R.id.mapcontrol)

        mapControl?.onCreate(savedInstanceState)

        //Wait until the map resources are ready.
        mapControl?.onReady(OnReady { map: AzureMap -> })
    }

    public override fun onStart() {
        super.onStart()
        mapControl?.onStart()
    }

    public override fun onResume() {
        super.onResume()
        mapControl?.onResume()
    }

    public override fun onPause() {
        mapControl?.onPause()
        super.onPause()
    }

    public override fun onStop() {
        mapControl?.onStop()
        super.onStop()
    }

    override fun onLowMemory() {
        mapControl?.onLowMemory()
        super.onLowMemory()
    }

    override fun onDestroy() {
        mapControl?.onDestroy()
        super.onDestroy()
    }

    override fun onSaveInstanceState(outState: Bundle) {
        super.onSaveInstanceState(outState)
        mapControl?.onSaveInstanceState(outState)
    }
}