> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 适用于原生 Java 和 Android Studio 的 Java 快速入门
> 下载 PlayFab Java 客户端 SDK JAR 文件、设置类路径，并在原生 Java 或 Android 中发起首次 LoginWithCustomID API 调用。
本快速入门帮助你使用 PlayFab JavaSDK 和一个简单的 Java 程序快速上手。
在调用任何 PlayFab API 之前，你必须拥有一个 [PlayFab 开发者帐户](https://developer.playfab.com)。
本教程的目标是：
* 获取所需的 JAR 文件。
* 将 JAR 文件添加到类路径中。
* 创建一个最简单的 Java 控制台应用程序，用于执行[自定义 ID 登录 API 调用](xref:titleid.playfabapi.com.client.authentication.loginwithcustomid)。
## 获取所需的 JAR 文件
为了使用 PlayFab JavaSDK，我们需要 PlayFab 客户端 JavaSDK 及其依赖项 Google GSON。
在[此处](https://github.com/PlayFab/JavaSDK/tree/versioned/builds)下载 PlayFab 客户端 JavaSDK JAR 库。查找 **client-sdk-\*.jar** 以及相应的 Java Doc \[可选但很有用]。
你可以在[此处](https://repo1.maven.org/maven2/com/google/code/gson/gson/2.8.0/)下载最新的 Google GSON。查找 **gson-\*.jar**。
## 使用 Intellij Idea 进行项目设置
初始化一个简单的 Intellij Idea Java 项目后，请确保按以下示例所示放置所需的 JAR 文件。
下一步是将 JAR 文件添加到类路径中。导航到 **File** -> **,**，如下例所示。
导航到 **Libraries**，然后按下图所示添加一个新的 Java 库。
选择你添加到 libs 文件夹中的 JAR 文件，然后如下所示选择 **OK**。
如果系统要求选择 **Module**，请选择列表中的第一个。确保所有 JAR 文件都已添加到库列表中。
## 使用任意 IDE 进行项目设置
主要要求是将 JAR 文件添加到类路径中。请查阅你所用 IDE 的指南，了解如何将 JAR 文件添加到类路径中。
## 设置你的第一个 API 调用
使用下面所示的代码作为你的主类代码。
```java theme={null}
import java.util.concurrent.*;
import java.util.*;
import com.playfab.PlayFabErrors.*;
import com.playfab.PlayFabSettings;
import com.playfab.PlayFabClientModels;
import com.playfab.PlayFabClientAPI;
public class Main
{
private static boolean _running = true;
public static void main(String[] args) {
PlayFabSettings.TitleId = "144";
PlayFabClientModels.LoginWithCustomIDRequest request = new PlayFabClientModels.LoginWithCustomIDRequest();
request.CustomId = "GettingStartedGuide";
request.CreateAccount = true;
FutureTask> loginTask = PlayFabClientAPI.LoginWithCustomIDAsync(request);
loginTask.run();
while (_running) {
if (loginTask.isDone()) { // You would probably want a more sophisticated way of tracking pending async API calls in a real game
OnLoginComplete(loginTask);
}
// Presumably this would be your main game loop, doing other things
try {
Thread.sleep(1);
} catch(Exception e) {
System.out.println("Critical error in the example main loop: " + e);
}
}
}
private static void OnLoginComplete(FutureTask> loginTask) {
PlayFabResult result = null;
try {
result = loginTask.get(); // Wait for the result from the async call
} catch(Exception e) {
System.out.println("Exception in PlayFab api call: " + e); // Did you assign your PlayFabSettings.TitleId correctly?
}
if (result != null && result.Result != null) {
System.out.println("Congratulations, you made your first successful API call!");
} else if (result != null && result.Error != null) {
System.out.println("Something went wrong with your first API call.");
System.out.println("Here's some debug information:");
System.out.println(CompileErrorsFromResult(result));
}
_running = false; // Because this is just an example, successful login triggers the end of the program
}
// This is a utility function we haven't put into the core SDK yet. Feel free to use it.
private static