Dieser Browser wird nicht mehr unterstützt.
Führen Sie ein Upgrade auf Microsoft Edge durch, um die neuesten Features, Sicherheitsupdates und den technischen Support zu nutzen.
In diesem Tutorial erstellen Sie eine Android-App, die in Microsoft Entra ID eingebunden wird, um Benutzer anzumelden und ein Zugriffstoken abzurufen, mit dem die Microsoft Graph-API aufgerufen werden kann.
Am Ende dieses Tutorials wird Ihre Anwendung Anmeldungen von persönlichen Microsoft-Konten (einschließlich outlook.com, live.com und anderen) sowie von Geschäfts-, Schul- oder Unikonten von allen Unternehmen oder Organisationen akzeptieren, die Azure AD nutzen.
Dieses Tutorial umfasst folgende Punkte:
Mit der App in diesem Tutorial werden Benutzer angemeldet und Daten in ihrem Namen abgerufen. Auf diese Daten wird über eine geschützte API (Microsoft Graph-API) zugegriffen, für die eine Autorisierung erforderlich ist und die über Microsoft Identity Platform geschützt ist.
Dieses Beispiel verwendet die Microsoft-Authentifizierungsbibliothek (Microsoft Authentication Library, MSAL) für Android zum Implementieren der Authentifizierung: com.microsoft.identity.client.
Führen Sie diese Schritte aus, um ein neues Projekt zu erstellen, wenn Sie noch keine Android-Anwendung haben.
Melden Sie sich beim Microsoft Entra Admin Center mindestens mit der Rolle Anwendungsentwickler an.
Wenn Sie Zugriff auf mehrere Mandanten haben, verwenden Sie das Symbol für 
Einstellungen im oberen Menü, um zum Mandanten zu wechseln, in dem Sie die Anwendung über das Menü Verzeichnisse + Abonnements registrieren möchten.
Browsen Sie zu Identität>Anwendungen>App-Registrierungen.
Wählen Sie Neue Registrierung aus.
Geben Sie einen Namen für Ihre Anwendung ein. Benutzern Ihrer App wird wahrscheinlich dieser Namen angezeigt. Sie können ihn später ändern.
Wählen Sie bei Unterstützte Kontotypen die Option Konten in allen Organisationsverzeichnissen (beliebiges Microsoft Entra-Verzeichnis: mehrere Mandanten) und persönliche Microsoft-Konten (z. B. Skype, Xbox) aus. Wenn Sie Informationen zu den verschiedenen Kontotypen benötigen, wählen Sie Entscheidungshilfe aus.
Wählen Sie Registrieren.
Wählen Sie unter Verwalten die Optionen Authentifizierung>Plattform hinzufügen>Android aus.
Geben Sie den Paketnamen Ihres Projekts ein. Wenn Sie den Beispielcode heruntergeladen haben, lautet dieser Wert com.azuresamples.msalandroidapp.
Klicken Sie auf der Seite Android-App konfigurieren im Abschnitt Signatur-Hash auf Generieren eines Signatur-Hash für die Entwicklung, und kopieren Sie den KeyTool-Befehl in Ihre Befehlszeile.
Geben Sie den von KeyTool generierten Signaturhash ein.
Wählen Sie Konfigurieren aus, und speichern Sie die MSAL-Konfiguration, die im Bereich Android-Konfiguration angezeigt wird, damit Sie diese später beim Konfigurieren Ihrer App eingeben können.
Wählen Sie Fertigaus.
Navigieren Sie im Projektbereich von Android Studio zu app\src\main\res.
Klicken Sie mit der rechten Maustaste auf res, und wählen Sie New>Directory („Neu“ > „Verzeichnis“) aus. Geben Sie raw als neuen Verzeichnisnamen ein, und wählen Sie OK.
Erstellen Sie unter app>src>main>res>raw eine neue JSON-Datei namens auth_config_single_account.json, und fügen Sie die MSAL-Konfiguration ein, die Sie zuvor gespeichert haben.
Fügen Sie unterhalb des Umleitungs-URIs Folgendes ein:
"account_mode" : "SINGLE",
Ihre Konfigurationsdatei sollte in etwa wie folgt aussehen:
{
"client_id": "00001111-aaaa-bbbb-3333-cccc4444",
"authorization_user_agent": "WEBVIEW",
"redirect_uri": "msauth://com.azuresamples.msalandroidapp/00001111%cccc4444%3D",
"broker_redirect_uri_registered": true,
"account_mode": "SINGLE",
"authorities": [
{
"type": "AAD",
"audience": {
"type": "AzureADandPersonalMicrosoftAccount",
"tenant_id": "common"
}
}
]
}
Da in diesem Tutorial nur veranschaulicht wird, wie Sie eine App im Einzelkontomodus konfigurieren, finden Sie weitere Informationen unter Einzelkontomodus vs. Mehrfachkontomodus und Konfigurieren Ihrer App
Es wird die Verwendung von „WEBVIEW“ empfohlen. Wenn Sie „authorization_user_agent“ in Ihrer App als „BROWSER“ konfigurieren möchten, müssen Sie die folgenden Änderungen vornehmen.
a) Aktualisieren Sie „auth_config_single_account.json“ mit: "authorization_user_agent": "Browser".
b) Aktualisieren Sie „AndroidManifest.xml“. Fügen Sie in der App unter app>src>main>AndroidManifest.xml die Aktivität BrowserTabActivity als untergeordnetes Element des <application>-Elements hinzu. Dieser Eintrag ermöglicht Microsoft Entra ID den Rückruf an Ihre Anwendung nach Abschluss der Authentifizierung:
<!--Intent filter to capture System Browser or Authenticator calling back to our app after sign-in-->
<activity
android:name="com.microsoft.identity.client.BrowserTabActivity"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="msauth"
android:host="Enter_the_Package_Name"
android:path="/Enter_the_Signature_Hash" />
</intent-filter>
</activity>
android:host=. zu ersetzen. Er sollte wie folgt aussehen: com.azuresamples.msalandroidapp.android:path= zu ersetzen. Stellen Sie sicher, dass Ihr Signatur-Hash mit einem führenden / beginnt. Er sollte wie folgt aussehen: /aB1cD2eF3gH4+iJ5kL6-mN7oP8q=.Diese Werte finden Sie ebenfalls auf dem Blatt „Authentifizierung“ Ihrer App-Registrierung.
Navigieren Sie im Android Studio-Projektfenster zu app>build.gradle, und fügen Sie im Abschnitt Abhängigkeiten die folgenden Bibliotheken hinzu:
implementation 'com.microsoft.identity.client:msal:5.0.0'
implementation 'com.android.volley:volley:1.2.1'
Öffnen Sie im Android Studio-Projektfenster settings.gradle, und deklarieren Sie das folgende Maven-Repository im Abschnitt dependencyResolutionManagement>repositories:
maven {
url 'https://pkgs.dev.azure.com/MicrosoftDeviceSDK/DuoSDK-Public/_packaging/Duo-SDK-Feed/maven/v1'
}
Wählen Sie in der Benachrichtigungsleiste Jetzt synchronisieren aus.
In app>src>main>java>com.example(Name Ihrer App). Erstellen Sie die folgenden Android-Fragmente:
Öffnen Sie MSGraphRequestWrapper.java, und ersetzen Sie den Code durch den folgenden Codeschnipsel, um die Microsoft Graph-API mithilfe des von MSAL bereitgestellten Tokens aufzurufen:
package com.azuresamples.msalandroidapp;
import android.content.Context;
import android.util.Log;
import androidx.annotation.NonNull;
import com.android.volley.DefaultRetryPolicy;
import com.android.volley.Request;
import com.android.volley.RequestQueue;
import com.android.volley.Response;
import com.android.volley.toolbox.JsonObjectRequest;
import com.android.volley.toolbox.Volley;
import org.json.JSONObject;
import java.util.HashMap;
import java.util.Map;
public class MSGraphRequestWrapper {
private static final String TAG = MSGraphRequestWrapper.class.getSimpleName();
// See: https://docs.microsoft.com/en-us/graph/deployments#microsoft-graph-and-graph-explorer-service-root-endpoints
public static final String MS_GRAPH_ROOT_ENDPOINT = "https://graph.microsoft.com/";
/**
* Use Volley to make an HTTP request with
* 1) a given MSGraph resource URL
* 2) an access token
* to obtain MSGraph data.
**/
public static void callGraphAPIUsingVolley(@NonNull final Context context,
@NonNull final String graphResourceUrl,
@NonNull final String accessToken,
@NonNull final Response.Listener<JSONObject> responseListener,
@NonNull final Response.ErrorListener errorListener) {
Log.d(TAG, "Starting volley request to graph");
/* Make sure we have a token to send to graph */
if (accessToken == null || accessToken.length() == 0) {
return;
}
RequestQueue queue = Volley.newRequestQueue(context);
JSONObject parameters = new JSONObject();
try {
parameters.put("key", "value");
} catch (Exception e) {
Log.d(TAG, "Failed to put parameters: " + e.toString());
}
JsonObjectRequest request = new JsonObjectRequest(Request.Method.GET, graphResourceUrl,
parameters, responseListener, errorListener) {
@Override
public Map<String, String> getHeaders() {
Map<String, String> headers = new HashMap<>();
headers.put("Authorization", "Bearer " + accessToken);
return headers;
}
};
Log.d(TAG, "Adding HTTP GET to Queue, Request: " + request.toString());
request.setRetryPolicy(new DefaultRetryPolicy(
3000,
DefaultRetryPolicy.DEFAULT_MAX_RETRIES,
DefaultRetryPolicy.DEFAULT_BACKOFF_MULT));
queue.add(request);
}
}
Öffnen Sie OnFragmentInteractionListener.java, und ersetzen Sie den Code durch den folgenden Codeschnipsel, um die Kommunikation zwischen verschiedenen Fragmenten zu ermöglichen:
package com.azuresamples.msalandroidapp;
/**
* This interface must be implemented by activities that contain this
* fragment to allow an interaction in this fragment to be communicated
* to the activity and potentially other fragments contained in that
* activity.
* <p>
* See the Android Training lesson <a href=
* "http://developer.android.com/training/basics/fragments/communicating.html"
* >Communicating with Other Fragments</a> for more information.
*/
public interface OnFragmentInteractionListener {
}
Öffnen Sie SingleAccountModeFragment.java, und ersetzen Sie den Code durch den folgenden Codeschnipsel, um eine Einzelkontoanwendung zu initialisieren, ein Benutzerkonto zu laden und ein Token abzurufen, um die Microsoft Graph-API aufzurufen:
package com.azuresamples.msalandroidapp;
import android.os.Bundle;
import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.fragment.app.Fragment;
import android.util.Log;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.Button;
import android.widget.TextView;
import android.widget.Toast;
import com.android.volley.Response;
import com.android.volley.VolleyError;
import com.microsoft.identity.client.AuthenticationCallback;
import com.microsoft.identity.client.IAccount;
import com.microsoft.identity.client.IAuthenticationResult;
import com.microsoft.identity.client.IPublicClientApplication;
import com.microsoft.identity.client.ISingleAccountPublicClientApplication;
import com.microsoft.identity.client.PublicClientApplication;
import com.microsoft.identity.client.SilentAuthenticationCallback;
import com.microsoft.identity.client.exception.MsalClientException;
import com.microsoft.identity.client.exception.MsalException;
import com.microsoft.identity.client.exception.MsalServiceException;
import com.microsoft.identity.client.exception.MsalUiRequiredException;
import org.json.JSONObject;
/**
* Implementation sample for 'Single account' mode.
* <p>
* If your app only supports one account being signed-in at a time, this is for you.
* This requires "account_mode" to be set as "SINGLE" in the configuration file.
* (Please see res/raw/auth_config_single_account.json for more info).
* <p>
* Please note that switching mode (between 'single' and 'multiple' might cause a loss of data.
*/
public class SingleAccountModeFragment extends Fragment {
private static final String TAG = SingleAccountModeFragment.class.getSimpleName();
/* UI & Debugging Variables */
Button signInButton;
Button signOutButton;
Button callGraphApiInteractiveButton;
Button callGraphApiSilentButton;
TextView scopeTextView;
TextView graphResourceTextView;
TextView logTextView;
TextView currentUserTextView;
TextView deviceModeTextView;
/* Azure AD Variables */
private ISingleAccountPublicClientApplication mSingleAccountApp;
private IAccount mAccount;
@Override
public View onCreateView(LayoutInflater inflater,
ViewGroup container,
Bundle savedInstanceState) {
// Inflate the layout for this fragment
final View view = inflater.inflate(R.layout.fragment_single_account_mode, container, false);
initializeUI(view);
// Creates a PublicClientApplication object with res/raw/auth_config_single_account.json
PublicClientApplication.createSingleAccountPublicClientApplication(getContext(),
R.raw.auth_config_single_account,
new IPublicClientApplication.ISingleAccountApplicationCreatedListener() {
@Override
public void onCreated(ISingleAccountPublicClientApplication application) {
/**
* This test app assumes that the app is only going to support one account.
* This requires "account_mode" : "SINGLE" in the config json file.
**/
mSingleAccountApp = application;
loadAccount();
}
@Override
public void onError(MsalException exception) {
displayError(exception);
}
});
return view;
}
/**
* Initializes UI variables and callbacks.
*/
private void initializeUI(@NonNull final View view) {
signInButton = view.findViewById(R.id.btn_signIn);
signOutButton = view.findViewById(R.id.btn_removeAccount);
callGraphApiInteractiveButton = view.findViewById(R.id.btn_callGraphInteractively);
callGraphApiSilentButton = view.findViewById(R.id.btn_callGraphSilently);
scopeTextView = view.findViewById(R.id.scope);
graphResourceTextView = view.findViewById(R.id.msgraph_url);
logTextView = view.findViewById(R.id.txt_log);
currentUserTextView = view.findViewById(R.id.current_user);
deviceModeTextView = view.findViewById(R.id.device_mode);
final String defaultGraphResourceUrl = MSGraphRequestWrapper.MS_GRAPH_ROOT_ENDPOINT + "v1.0/me";
graphResourceTextView.setText(defaultGraphResourceUrl);
signInButton.setOnClickListener(new View.OnClickListener() {
public void onClick(View v) {
if (mSingleAccountApp == null) {
return;
}
mSingleAccountApp.signIn(getActivity(), null, getScopes(), getAuthInteractiveCallback());
}
});
signOutButton.setOnClickListener(new View.OnClickListener() {
public void onClick(View v) {
if (mSingleAccountApp == null) {
return;
}
/**
* Removes the signed-in account and cached tokens from this app (or device, if the device is in shared mode).
*/
mSingleAccountApp.signOut(new ISingleAccountPublicClientApplication.SignOutCallback() {
@Override
public void onSignOut() {
mAccount = null;
updateUI();
showToastOnSignOut();
}
@Override
public void onError(@NonNull MsalException exception) {
displayError(exception);
}
});
}
});
callGraphApiInteractiveButton.setOnClickListener(new View.OnClickListener() {
public void onClick(View v) {
if (mSingleAccountApp == null) {
return;
}
/**
* If acquireTokenSilent() returns an error that requires an interaction (MsalUiRequiredException),
* invoke acquireToken() to have the user resolve the interrupt interactively.
*
* Some example scenarios are
* - password change
* - the resource you're acquiring a token for has a stricter set of requirement than your Single Sign-On refresh token.
* - you're introducing a new scope which the user has never consented for.
*/
mSingleAccountApp.acquireToken(getActivity(), getScopes(), getAuthInteractiveCallback());
}
});
callGraphApiSilentButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (mSingleAccountApp == null) {
return;
}
/**
* Once you've signed the user in,
* you can perform acquireTokenSilent to obtain resources without interrupting the user.
*/
mSingleAccountApp.acquireTokenSilentAsync(getScopes(), mAccount.getAuthority(), getAuthSilentCallback());
}
});
}
@Override
public void onResume() {
super.onResume();
/**
* The account may have been removed from the device (if broker is in use).
*
* In shared device mode, the account might be signed in/out by other apps while this app is not in focus.
* Therefore, we want to update the account state by invoking loadAccount() here.
*/
loadAccount();
}
/**
* Extracts a scope array from a text field,
* i.e. from "User.Read User.ReadWrite" to ["user.read", "user.readwrite"]
*/
private String[] getScopes() {
return scopeTextView.getText().toString().toLowerCase().split(" ");
}
/**
* Load the currently signed-in account, if there's any.
*/
private void loadAccount() {
if (mSingleAccountApp == null) {
return;
}
mSingleAccountApp.getCurrentAccountAsync(new ISingleAccountPublicClientApplication.CurrentAccountCallback() {
@Override
public void onAccountLoaded(@Nullable IAccount activeAccount) {
// You can use the account data to update your UI or your app database.
mAccount = activeAccount;
updateUI();
}
@Override
public void onAccountChanged(@Nullable IAccount priorAccount, @Nullable IAccount currentAccount) {
if (currentAccount == null) {
// Perform a cleanup task as the signed-in account changed.
showToastOnSignOut();
}
}
@Override
public void onError(@NonNull MsalException exception) {
displayError(exception);
}
});
}
/**
* Callback used in for silent acquireToken calls.
*/
private SilentAuthenticationCallback getAuthSilentCallback() {
return new SilentAuthenticationCallback() {
@Override
public void onSuccess(IAuthenticationResult authenticationResult) {
Log.d(TAG, "Successfully authenticated");
/* Successfully got a token, use it to call a protected resource - MSGraph */
callGraphAPI(authenticationResult);
}
@Override
public void onError(MsalException exception) {
/* Failed to acquireToken */
Log.d(TAG, "Authentication failed: " + exception.toString());
displayError(exception);
if (exception instanceof MsalClientException) {
/* Exception inside MSAL, more info inside MsalError.java */
} else if (exception instanceof MsalServiceException) {
/* Exception when communicating with the STS, likely config issue */
} else if (exception instanceof MsalUiRequiredException) {
/* Tokens expired or no session, retry with interactive */
}
}
};
}
/**
* Callback used for interactive request.
* If succeeds we use the access token to call the Microsoft Graph.
* Does not check cache.
*/
private AuthenticationCallback getAuthInteractiveCallback() {
return new AuthenticationCallback() {
@Override
public void onSuccess(IAuthenticationResult authenticationResult) {
/* Successfully got a token, use it to call a protected resource - MSGraph */
Log.d(TAG, "Successfully authenticated");
Log.d(TAG, "ID Token: " + authenticationResult.getAccount().getClaims().get("id_token"));
/* Update account */
mAccount = authenticationResult.getAccount();
updateUI();
/* call graph */
callGraphAPI(authenticationResult);
}
@Override
public void onError(MsalException exception) {
/* Failed to acquireToken */
Log.d(TAG, "Authentication failed: " + exception.toString());
displayError(exception);
if (exception instanceof MsalClientException) {
/* Exception inside MSAL, more info inside MsalError.java */
} else if (exception instanceof MsalServiceException) {
/* Exception when communicating with the STS, likely config issue */
}
}
@Override
public void onCancel() {
/* User canceled the authentication */
Log.d(TAG, "User cancelled login.");
}
};
}
/**
* Make an HTTP request to obtain MSGraph data
*/
private void callGraphAPI(final IAuthenticationResult authenticationResult) {
MSGraphRequestWrapper.callGraphAPIUsingVolley(
getContext(),
graphResourceTextView.getText().toString(),
authenticationResult.getAccessToken(),
new Response.Listener<JSONObject>() {
@Override
public void onResponse(JSONObject response) {
/* Successfully called graph, process data and send to UI */
Log.d(TAG, "Response: " + response.toString());
displayGraphResult(response);
}
},
new Response.ErrorListener() {
@Override
public void onErrorResponse(VolleyError error) {
Log.d(TAG, "Error: " + error.toString());
displayError(error);
}
});
}
//
// Helper methods manage UI updates
// ================================
// displayGraphResult() - Display the graph response
// displayError() - Display the graph response
// updateSignedInUI() - Updates UI when the user is signed in
// updateSignedOutUI() - Updates UI when app sign out succeeds
//
/**
* Display the graph response
*/
private void displayGraphResult(@NonNull final JSONObject graphResponse) {
logTextView.setText(graphResponse.toString());
}
/**
* Display the error message
*/
private void displayError(@NonNull final Exception exception) {
logTextView.setText(exception.toString());
}
/**
* Updates UI based on the current account.
*/
private void updateUI() {
if (mAccount != null) {
signInButton.setEnabled(false);
signOutButton.setEnabled(true);
callGraphApiInteractiveButton.setEnabled(true);
callGraphApiSilentButton.setEnabled(true);
currentUserTextView.setText(mAccount.getUsername());
} else {
signInButton.setEnabled(true);
signOutButton.setEnabled(false);
callGraphApiInteractiveButton.setEnabled(false);
callGraphApiSilentButton.setEnabled(false);
currentUserTextView.setText("None");
}
deviceModeTextView.setText(mSingleAccountApp.isSharedDevice() ? "Shared" : "Non-shared");
}
/**
* Updates UI when app sign out succeeds
*/
private void showToastOnSignOut() {
final String signOutText = "Signed Out.";
currentUserTextView.setText("");
Toast.makeText(getContext(), signOutText, Toast.LENGTH_SHORT)
.show();
}
}
Öffnen Sie MainActivity.java, und ersetzen Sie den Code durch den folgenden Codeschnipsel, um die Benutzeroberfläche zu verwalten.
package com.azuresamples.msalandroidapp;
import android.os.Bundle;
import androidx.annotation.NonNull;
import androidx.appcompat.app.ActionBarDrawerToggle;
import androidx.appcompat.app.AppCompatActivity;
import androidx.appcompat.widget.Toolbar;
import androidx.constraintlayout.widget.ConstraintLayout;
import androidx.core.view.GravityCompat;
import android.view.MenuItem;
import android.view.View;
import androidx.drawerlayout.widget.DrawerLayout;
import androidx.fragment.app.Fragment;
import androidx.fragment.app.FragmentTransaction;
import com.google.android.material.navigation.NavigationView;
public class MainActivity extends AppCompatActivity
implements NavigationView.OnNavigationItemSelectedListener,
OnFragmentInteractionListener{
enum AppFragment {
SingleAccount
}
private AppFragment mCurrentFragment;
private ConstraintLayout mContentMain;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mContentMain = findViewById(R.id.content_main);
Toolbar toolbar = findViewById(R.id.toolbar);
setSupportActionBar(toolbar);
DrawerLayout drawer = findViewById(R.id.drawer_layout);
NavigationView navigationView = findViewById(R.id.nav_view);
ActionBarDrawerToggle toggle = new ActionBarDrawerToggle(
this, drawer, toolbar, R.string.navigation_drawer_open, R.string.navigation_drawer_close);
drawer.addDrawerListener(toggle);
toggle.syncState();
navigationView.setNavigationItemSelectedListener(this);
//Set default fragment
navigationView.setCheckedItem(R.id.nav_single_account);
setCurrentFragment(AppFragment.SingleAccount);
}
@Override
public boolean onNavigationItemSelected(final MenuItem item) {
final DrawerLayout drawer = findViewById(R.id.drawer_layout);
drawer.addDrawerListener(new DrawerLayout.DrawerListener() {
@Override
public void onDrawerSlide(@NonNull View drawerView, float slideOffset) { }
@Override
public void onDrawerOpened(@NonNull View drawerView) { }
@Override
public void onDrawerClosed(@NonNull View drawerView) {
// Handle navigation view item clicks here.
int id = item.getItemId();
if (id == R.id.nav_single_account) {
setCurrentFragment(AppFragment.SingleAccount);
}
drawer.removeDrawerListener(this);
}
@Override
public void onDrawerStateChanged(int newState) { }
});
drawer.closeDrawer(GravityCompat.START);
return true;
}
private void setCurrentFragment(final AppFragment newFragment){
if (newFragment == mCurrentFragment) {
return;
}
mCurrentFragment = newFragment;
setHeaderString(mCurrentFragment);
displayFragment(mCurrentFragment);
}
private void setHeaderString(final AppFragment fragment){
switch (fragment) {
case SingleAccount:
getSupportActionBar().setTitle("Single Account Mode");
return;
}
}
private void displayFragment(final AppFragment fragment){
switch (fragment) {
case SingleAccount:
attachFragment(new com.azuresamples.msalandroidapp.SingleAccountModeFragment());
return;
}
}
private void attachFragment(final Fragment fragment) {
getSupportFragmentManager()
.beginTransaction()
.setTransitionStyle(FragmentTransaction.TRANSIT_FRAGMENT_FADE)
.replace(mContentMain.getId(),fragment)
.commit();
}
}
Hinweis
Stellen Sie sicher, dass Sie den Paketnamen so aktualisieren, dass er ihrem Android-Projektpaketnamen entspricht.
Ein Layout ist eine Datei, die die visuelle Struktur und Darstellung einer Benutzeroberfläche definiert und die Anordnung von UI-Komponenten angibt. Sie ist in XML geschrieben. Die folgenden XML-Beispiele werden bereitgestellt, wenn Sie Ihre Benutzeroberfläche aus diesem Tutorial modellieren möchten:
In app>src>main>res>layout>activity_main.xml. Ersetzen Sie den Inhalt von activity_main.xml durch den folgenden Codeschnipsel, um Schaltflächen und Textfelder anzuzeigen:
<?xml version="1.0" encoding="utf-8"?>
<androidx.drawerlayout.widget.DrawerLayout 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:id="@+id/drawer_layout"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:fitsSystemWindows="true"
tools:openDrawer="start">
<include
layout="@layout/app_bar_main"
android:layout_width="match_parent"
android:layout_height="match_parent" />
<com.google.android.material.navigation.NavigationView
android:id="@+id/nav_view"
android:layout_width="wrap_content"
android:layout_height="match_parent"
android:layout_gravity="start"
android:fitsSystemWindows="true"
app:headerLayout="@layout/nav_header_main"
app:menu="@menu/activity_main_drawer" />
</androidx.drawerlayout.widget.DrawerLayout>
In app>src>main>res>layout>app_bar_main.xml. Wenn Sie in Ihrem Ordner nicht über app_bar_main.xml verfügen, erstellen Sie den folgenden Codeschnipsel, und fügen Sie ihn hinzu:
<?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">
<com.google.android.material.appbar.AppBarLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:theme="@style/AppTheme.AppBarOverlay">
<androidx.appcompat.widget.Toolbar
android:id="@+id/toolbar"
android:layout_width="match_parent"
android:layout_height="?attr/actionBarSize"
android:background="?attr/colorPrimary"
app:popupTheme="@style/AppTheme.PopupOverlay" />
</com.google.android.material.appbar.AppBarLayout>
<include layout="@layout/content_main" />
</androidx.coordinatorlayout.widget.CoordinatorLayout>
In app>src>main>res>layout>content_main.xml. Wenn Sie in Ihrem Ordner nicht über content_main.xml verfügen, erstellen Sie den folgenden Codeschnipsel, und fügen Sie ihn hinzu:
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/content_main"
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"
app:layout_behavior="@string/appbar_scrolling_view_behavior"
tools:context=".MainActivity"
tools:showIn="@layout/app_bar_main">
</androidx.constraintlayout.widget.ConstraintLayout>
In app>src>main>res>layout>fragment_m_s_graph_request_wrapper.xml. Wenn Sie in Ihrem Ordner nicht über fragment_m_s_graph_request_wrapper.xml verfügen, erstellen Sie den folgenden Codeschnipsel, und fügen Sie ihn hinzu:
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MSGraphRequestWrapper">
<!-- TODO: Update blank fragment layout -->
<TextView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:text="@string/hello_blank_fragment" />
</FrameLayout>
In app>src>main>res>layout>fragment_on_interaction_listener.xml. Wenn Sie in Ihrem Ordner nicht über fragment_on_interaction_listener.xml verfügen, erstellen Sie den folgenden Codeschnipsel, und fügen Sie ihn hinzu:
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".OnFragmentInteractionListener">
<!-- TODO: Update blank fragment layout -->
<TextView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:text="@string/hello_blank_fragment" />
</FrameLayout>
In app>src>main>res>layout>fragment_single_account_mode.xml. Wenn Sie in Ihrem Ordner nicht über fragment_single_account_mode.xml verfügen, erstellen Sie den folgenden Codeschnipsel, und fügen Sie ihn hinzu:
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".SingleAccountModeFragment">
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
tools:context=".SingleAccountModeFragment">
<LinearLayout
android:id="@+id/activity_main"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingBottom="@dimen/activity_vertical_margin">
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:paddingTop="5dp"
android:paddingBottom="5dp"
android:weightSum="10">
<TextView
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="3"
android:layout_gravity="center_vertical"
android:textStyle="bold"
android:text="Scope" />
<LinearLayout
android:layout_width="0dp"
android:layout_height="wrap_content"
android:orientation="vertical"
android:layout_weight="7">
<EditText
android:id="@+id/scope"
android:layout_height="wrap_content"
android:layout_width="match_parent"
android:text="user.read"
android:textSize="12sp" />
<TextView
android:layout_height="wrap_content"
android:layout_width="match_parent"
android:paddingLeft="5dp"
android:text="Type in scopes delimited by space"
android:textSize="10sp" />
</LinearLayout>
</LinearLayout>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:paddingTop="5dp"
android:paddingBottom="5dp"
android:weightSum="10">
<TextView
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="3"
android:layout_gravity="center_vertical"
android:textStyle="bold"
android:text="MSGraph Resource URL" />
<LinearLayout
android:layout_width="0dp"
android:layout_height="wrap_content"
android:orientation="vertical"
android:layout_weight="7">
<EditText
android:id="@+id/msgraph_url"
android:layout_height="wrap_content"
android:layout_width="match_parent"
android:textSize="12sp" />
</LinearLayout>
</LinearLayout>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:paddingTop="5dp"
android:paddingBottom="5dp"
android:weightSum="10">
<TextView
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="3"
android:textStyle="bold"
android:text="Signed-in user" />
<TextView
android:id="@+id/current_user"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:paddingLeft="5dp"
android:layout_weight="7"
android:text="None" />
</LinearLayout>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:paddingTop="5dp"
android:paddingBottom="5dp"
android:weightSum="10">
<TextView
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="3"
android:textStyle="bold"
android:text="Device mode" />
<TextView
android:id="@+id/device_mode"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:paddingLeft="5dp"
android:layout_weight="7"
android:text="None" />
</LinearLayout>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="horizontal"
android:paddingTop="5dp"
android:paddingBottom="5dp"
android:weightSum="10">
<Button
android:id="@+id/btn_signIn"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="5"
android:gravity="center"
android:text="Sign In"/>
<Button
android:id="@+id/btn_removeAccount"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="5"
android:gravity="center"
android:text="Sign Out"
android:enabled="false"/>
</LinearLayout>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:gravity="center"
android:orientation="horizontal">
<Button
android:id="@+id/btn_callGraphInteractively"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="5"
android:text="Get Graph Data Interactively"
android:enabled="false"/>
<Button
android:id="@+id/btn_callGraphSilently"
android:layout_width="0dp"
android:layout_height="wrap_content"
android:layout_weight="5"
android:text="Get Graph Data Silently"
android:enabled="false"/>
</LinearLayout>
<TextView
android:id="@+id/txt_log"
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_marginTop="20dp"
android:layout_weight="0.8"
android:text="Output goes here..." />
</LinearLayout>
</LinearLayout>
</FrameLayout>
In app>src>main>res>layout>nav_header_main.xml. Wenn Sie in Ihrem Ordner nicht über nav_header_main.xml verfügen, erstellen Sie den folgenden Codeschnipsel, und fügen Sie ihn hinzu:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="@dimen/nav_header_height"
android:background="@drawable/side_nav_bar"
android:gravity="bottom"
android:orientation="vertical"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingBottom="@dimen/activity_vertical_margin"
android:theme="@style/ThemeOverlay.AppCompat.Dark">
<ImageView
android:id="@+id/imageView"
android:layout_width="66dp"
android:layout_height="72dp"
android:contentDescription="@string/nav_header_desc"
android:paddingTop="@dimen/nav_header_vertical_spacing"
app:srcCompat="@drawable/microsoft_logo" />
<TextView
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:paddingTop="@dimen/nav_header_vertical_spacing"
android:text="Azure Samples"
android:textAppearance="@style/TextAppearance.AppCompat.Body1" />
<TextView
android:id="@+id/textView"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="MSAL Android" />
</LinearLayout>
Im app>src>main>res>-Menü>activity_main_drawer.xml. Wenn Sie in Ihrem Ordner nicht über activity_main_drawer.xml verfügen, erstellen Sie den folgenden Codeschnipsel, und fügen Sie ihn hinzu:
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
tools:showIn="navigation_view">
<group android:checkableBehavior="single">
<item
android:id="@+id/nav_single_account"
android:icon="@drawable/ic_single_account_24dp"
android:title="Single Account Mode" />
</group>
</menu>
In app>src>main>res>values>dimens.xml. Ersetzen Sie den Inhalt von dimens.xml durch den folgenden Codeschnipsel:
<resources>
<dimen name="fab_margin">16dp</dimen>
<dimen name="activity_horizontal_margin">16dp</dimen>
<dimen name="activity_vertical_margin">16dp</dimen>
<dimen name="nav_header_height">176dp</dimen>
<dimen name="nav_header_vertical_spacing">8dp</dimen>
</resources>
In app>src>main>res>values>colors.xml. Ersetzen Sie den Inhalt von colors.xml durch den folgenden Codeschnipsel:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<color name="purple_200">#FFBB86FC</color>
<color name="purple_500">#FF6200EE</color>
<color name="purple_700">#FF3700B3</color>
<color name="teal_200">#FF03DAC5</color>
<color name="teal_700">#FF018786</color>
<color name="black">#FF000000</color>
<color name="white">#FFFFFFFF</color>
<color name="colorPrimary">#008577</color>
<color name="colorPrimaryDark">#00574B</color>
<color name="colorAccent">#D81B60</color>
</resources>
In den app>src>main>res>-Werten>strings.xml. Ersetzen Sie den Inhalt von strings.xml durch den folgenden Codeschnipsel:
<resources>
<string name="app_name">MSALAndroidapp</string>
<string name="action_settings">Settings</string>
<!-- Strings used for fragments for navigation -->
<string name="first_fragment_label">First Fragment</string>
<string name="second_fragment_label">Second Fragment</string>
<string name="nav_header_desc">Navigation header</string>
<string name="navigation_drawer_open">Open navigation drawer</string>
<string name="navigation_drawer_close">Close navigation drawer</string>
<string name="next">Next</string>
<string name="previous">Previous</string>
<string name="hello_first_fragment">Hello first fragment</string>
<string name="hello_second_fragment">Hello second fragment. Arg: %1$s</string>
<!-- TODO: Remove or change this placeholder text -->
<string name="hello_blank_fragment">Hello blank fragment</string>
</resources>
In app>src>main>res>values>styles.xml. Wenn Sie in Ihrem Ordner nicht über styles.xml verfügen, erstellen Sie den folgenden Codeschnipsel, und fügen Sie ihn hinzu:
<resources>
<!-- Base application theme. -->
<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
<!-- Customize your theme here. -->
<item name="colorPrimary">@color/colorPrimary</item>
<item name="colorPrimaryDark">@color/colorPrimaryDark</item>
<item name="colorAccent">@color/colorAccent</item>
</style>
<style name="AppTheme.NoActionBar">
<item name="windowActionBar">false</item>
<item name="windowNoTitle">true</item>
</style>
<style name="AppTheme.AppBarOverlay" parent="ThemeOverlay.AppCompat.Dark.ActionBar" />
<style name="AppTheme.PopupOverlay" parent="ThemeOverlay.AppCompat.Light" />
</resources>
In app>src>main>res>values>themes.xml. Ersetzen Sie den Inhalt von themes.xml durch den folgenden Codeschnipsel:
<resources xmlns:tools="http://schemas.android.com/tools">
<!-- Base application theme. -->
<style name="Theme.MSALAndroidapp" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
<!-- Primary brand color. -->
<item name="colorPrimary">@color/purple_500</item>
<item name="colorPrimaryVariant">@color/purple_700</item>
<item name="colorOnPrimary">@color/white</item>
<!-- Secondary brand color. -->
<item name="colorSecondary">@color/teal_200</item>
<item name="colorSecondaryVariant">@color/teal_700</item>
<item name="colorOnSecondary">@color/black</item>
<!-- Status bar color. -->
<item name="android:statusBarColor" tools:targetApi="21">?attr/colorPrimaryVariant</item>
<!-- Customize your theme here. -->
</style>
<style name="Theme.MSALAndroidapp.NoActionBar">
<item name="windowActionBar">false</item>
<item name="windowNoTitle">true</item>
</style>
<style name="Theme.MSALAndroidapp.AppBarOverlay" parent="ThemeOverlay.AppCompat.Dark.ActionBar" />
<style name="Theme.MSALAndroidapp.PopupOverlay" parent="ThemeOverlay.AppCompat.Light" />
</resources>
In app>src>main>res>drawable>ic_single_account_24dp.xml. Wenn Sie in Ihrem Ordner nicht über ic_single_account_24dp.xml verfügen, erstellen Sie den folgenden Codeschnipsel, und fügen Sie ihn hinzu:
<vector xmlns:android="http://schemas.android.com/apk/res/android"
android:width="24dp"
android:height="24dp"
android:viewportWidth="24.0"
android:viewportHeight="24.0">
<path
android:fillColor="#FF000000"
android:pathData="M12,12c2.21,0 4,-1.79 4,-4s-1.79,-4 -4,-4 -4,1.79 -4,4 1.79,4 4,4zM12,14c-2.67,0 -8,1.34 -8,4v2h16v-2c0,-2.66 -5.33,-4 -8,-4z"/>
</vector>
In app>src>main>res>drawable>side_nav_bar.xml. Wenn Sie in Ihrem Ordner nicht über side_nav_bar.xml verfügen, erstellen Sie den folgenden Codeschnipsel, und fügen Sie ihn hinzu:
<shape xmlns:android="http://schemas.android.com/apk/res/android"
android:shape="rectangle">
<gradient
android:angle="135"
android:centerColor="#009688"
android:endColor="#00695C"
android:startColor="#4DB6AC"
android:type="linear" />
</shape>
In app>src>main>res>drawable. Fügen Sie dem Ordner ein PNG-Microsoft-Logo mit dem Namen „microsoft_logo.png“ hinzu.
Wenn Sie Ihre Benutzeroberfläche in XML deklarieren, können Sie die Darstellung Ihrer App von dem Code, der ihr Verhalten steuert, trennen. Weitere Informationen zum Android-Layout finden Sie unter Layouts.
Erstellen Sie die App, und stellen Sie sie auf einem Testgerät oder in einem Emulator bereit. Sie sollten sich anmelden und Token für Microsoft Entra ID oder persönliche Microsoft-Konten abrufen können.
Nach der Anmeldung zeigt die App die vom Microsoft Graph-Endpunkt /me zurückgegebenen Daten an.
Wenn sich ein Benutzer zum ersten Mal bei Ihrer App anmeldet, wird er von Microsoft Identity aufgefordert, den angeforderten Berechtigungen zuzustimmen. Bei einigen Microsoft Entra-Mandanten ist die Benutzereinwilligung deaktiviert, sodass Administratoren im Namen aller Benutzer einwilligen müssen. Um dieses Szenario zu unterstützen, müssen Sie entweder einen eigenen Mandanten anlegen oder die Einwilligung des Administrators einholen.
Löschen Sie das im Schritt Registrieren Ihrer Anwendung erstellte App-Objekt, wenn Sie es nicht mehr benötigen.
Wenn Sie Hilfe benötigen, ein Problem melden möchten oder sich über Ihre Supportoptionen informieren möchten, finden Sie weitere Informationen unter Hilfe und Support für Entwickler.
Komplexere Szenarios finden Sie in einem vollständigen, funktionierenden Codebeispiel auf GitHub.
Weitere Informationen zum Erstellen von mobilen Apps, die in unserer mehrteiligen Szenarioreihe geschützte Web-APIs aufrufen, finden Sie unter:
Training
Modul
Anmelden von Benutzern mit Microsoft Entra ID in einer Java-Web-App - Training
Hier erfahren Sie, wie Sie Benutzer mit Microsoft Entra ID authentifizieren und in einer Java-Web-App mithilfe der Microsoft-Authentifizierungsbibliothek autorisierten Zugriff auf Daten erhalten.