> For the complete documentation index, see [llms.txt](https://app.developers.karte.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://app.developers.karte.io/app-faq/sdk-build-error.md).

# SDKを導入するとビルドエラーが起きる

SDKを導入時にビルドエラーが起きる場合は次の手順で確認を行ってください。

## iOS

### 1. Xcode / CocoaPods / Carthage が推奨バージョンであるか確認する

基本的にXcode / CocoaPods / Carthageのバージョンは最新版を推奨しています。\
参考: [SDKを導入する / 前提条件](/ios-sdk/setup-ios-sdk.md)

### 2. プロジェクトのクリーンやPodsの再インストールなどを行う

Xcodeを一度Cleanし、Derived Dataを削除、再起動すると問題が解決することがあります。\
あわせてPodsディレクトリの削除と `pod install` の再実行もお試しください。

### 3. 期待するモジュールが正しくインストールされているか確認する

Podfile.lockを開きインストールされたモジュールのバージョンを確認してください。\
古いモジュールがインストールされてしまう場合、 `pod repo update` でpodリポジトリの更新を行った後に `pod update #{ModuleName}` などでモジュールを最新化してください。

## Android

### 1. Android Studio / Gradle / Android Gradle Plugin などが推奨バージョンか確認する

参考: [SDKを導入する / 前提条件](/android-sdk/setup-android-sdk.md)

### 2. Android Gradle Plugin と Gradle のバージョンの組み合わせが正しいか確認する。

Android Gradle Pluginのバージョンによって、要求する Gradle のバージョンが変わります。\
正しい組み合わせになっているか公式サイトの 「[Gradle のアップデート](https://developer.android.com/studio/releases/gradle-plugin#updating-gradle)」情報からご確認ください。

### 3. プロジェクトのクリーンを行い、キャッシュを削除する

Clean Project や Invalidate Caches を行い Android Studio を再起動すると問題が解決することがありますのでお試しください。

## 問題が解決しない場合

[ネイティブSDKの調査に必要な情報 / ネイティブアプリのビルド環境](https://support.karte.io/post/7BaenUKSuy21CzqrsD5n9e#1-3)を参考に調査用の情報をご用意いただきチャットサポートからお問い合わせください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://app.developers.karte.io/app-faq/sdk-build-error.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.