Android

サポート環境

• Android minSdk 26 以上

• Android Gradle Plugin 8.0 以上

---

Step 1. パッケージをインストールする

Nubrick SDK は Maven Central から追加できます。

• Maven Central

Gradle (Groovy)

build.gradle に以下を追加します。

dependencies {
  implementation 'app.nubrick:nubrick:<LATEST_VERSION>'
}

Gradle (Kotlin DSL)

build.gradle.kts に以下を追加します。

dependencies {
  implementation("app.nubrick:nubrick:<LATEST_VERSION>")
}

Apache Maven

pom.xml に以下を追加します。

<dependency>
  <groupId>app.nubrick</groupId>
  <artifactId>nubrick</artifactId>
  <version>${LATEST_VERSION}</version>
</dependency>

Step 2. Nubrick SDK を初期化する

NubrickSDK.initialize(...) は、Embedding / RemoteConfig / dispatch など他の API を使う前に、必ず 1 回だけ実行してください。

Jetpack Compose

アプリ全体で 1 回だけ初期化するため、Application の onCreate で SDK を初期化し、Activity 側ではルート Composable を NubrickProvider { ... } で包みます。

import android.app.Application
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.height
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.Surface
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
import app.nubrick.nubrick.Config
import app.nubrick.nubrick.NubrickProvider
import app.nubrick.nubrick.NubrickSDK

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        NubrickSDK.initialize(
            context = this,
            config = Config(projectId = "<YOUR_NUBRICK_PROJECT_ID>")
        )
    }
}

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        setContent {
            NubrickProvider {
                Surface(
                    modifier = Modifier.fillMaxSize(),
                    color = MaterialTheme.colorScheme.background
                ) {
                    NubrickSDK.Embedding(
                        id = "ID_OF_YOUR_EMBEDDING",
                        modifier = Modifier.height(240.dp)
                    )
                }
            }
        }
    }
}

既存の Application クラスがある場合は、その onCreate で NubrickSDK.initialize(...) を実行してください。 Application クラスがない場合、新規作成して AndroidManifest.xml の android:name に指定してください。

Java / XML

Java と Android View を利用する場合も、Application の onCreate で SDK を初期化します。

import android.app.Application;

import app.nubrick.nubrick.Config;
import app.nubrick.nubrick.NubrickSDK;

public final class MyApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        Config config = new Config("<YOUR_NUBRICK_PROJECT_ID>");
        NubrickSDK.initialize(this, config);
    }
}

埋め込みコンポーネントは NubrickEmbeddingView で表示します。ポップアップなどのオーバーレイ配信を表示するには、アプリのコンテンツより上に NubrickOverlayView を 1 つ配置してください。

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout 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="match_parent">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <app.nubrick.nubrick.view.NubrickEmbeddingView
            android:id="@+id/nubrick_embedding"
            android:layout_width="match_parent"
            android:layout_height="240dp"
            app:nubrickExperimentId="ID_OF_YOUR_EMBEDDING" />
    </LinearLayout>

    <app.nubrick.nubrick.view.NubrickOverlayView
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
</FrameLayout>