【Android開発】アプリから新しい連絡先を追加する方法を解説

本記事では、Androidアプリから新しい連絡先を追加する方法を、サンプルコードとともにわかりやすく解説します。ContactsContractが提供するインテントを利用すれば、連絡先データベースを直接操作しなくても、標準の連絡先アプリの登録画面を呼び出して簡単に実装できます。

手順1：Android Studioで新規プロジェクトを作成する

Android Studioを起動し、メニューから「File → New Project」を選択して新しいプロジェクトを作成します。必要な項目をすべて入力してプロジェクトを完成させましょう。

手順2：レイアウトファイル（activity_main.xml）にコードを追加する

res/layout/activity_main.xml に以下のコードを記述します。連絡先の「名前」と「電話番号」を入力する2つのEditTextと、登録を実行するButtonを縦方向に配置したシンプルなレイアウトです。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:layout_margin="16dp"
    android:orientation="vertical"
    tools:context=".MainActivity">
    <EditText
        android:id="@+id/etContactName"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="Contact name"
        android:inputType="text" />
    <EditText
        android:id="@+id/etContactNumber"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="Contact number"
        android:inputType="number" />
    <Button
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:onClick="addContact"
        android:text="ADD" />
</LinearLayout>

手順3：MainActivityにコードを追加する

src/MainActivity に以下のコードを記述します。「ADD」ボタンがタップされると addContact() メソッドが呼び出され、入力された名前と電話番号をExtrasに格納したインテントが発行されます。これにより、標準の連絡先アプリの新規登録画面が起動します。登録結果は onActivityResult() で受け取り、成功・キャンセルそれぞれに応じてトーストで通知します。

package app.tutorialspoint.com.sample;
import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.provider.ContactsContract;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.EditText;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    public void addContact(View view) {
        EditText etContactName = findViewById(R.id.etContactName);
        EditText etContactNumber = findViewById(R.id.etContactNumber);
        String name = etContactName.getText().toString();
        String phone = etContactNumber.getText().toString();

        Intent contactIntent = new Intent(ContactsContract.Intents.Insert.ACTION);
        contactIntent.setType(ContactsContract.RawContacts.CONTENT_TYPE);
        contactIntent
                .putExtra(ContactsContract.Intents.Insert.NAME, name)
                .putExtra(ContactsContract.Intents.Insert.PHONE, phone);

        startActivityForResult(contactIntent, 1);
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
        super.onActivityResult(requestCode, resultCode, intent);
        if (requestCode == 1) {
            if (resultCode == Activity.RESULT_OK) {
                Toast.makeText(this, "Added Contact", Toast.LENGTH_SHORT).show();
            }
            if (resultCode == Activity.RESULT_CANCELED) {
                Toast.makeText(this, "Cancelled Added Contact",
                        Toast.LENGTH_SHORT).show();
            }
        }
    }
}

ポイント：インテントによる連絡先追加の仕組み

ContactsContract.Intents.Insert.ACTION をアクションに指定したインテントを startActivityForResult() で起動すると、システムが標準の連絡先アプリの登録画面を表示します。名前や電話番号の値は putExtra() で事前に渡しておけるため、画面を開いた時点で自動的に入力された状態になります。この方式では実際の保存処理を連絡先アプリ側が担うため、アプリ側に特別なパーミッションは不要という点も覚えておきましょう。

手順4：AndroidManifest.xmlにコードを追加する

androidManifest.xml に以下のコードを記述します。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.tutorialspoint.com.sample">
    <uses-permission android:name="android.permission.CALL_PHONE" />
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <receiver
            android:name=".DeviceAdmin"
            android:description="@string/app_description"
            android:label="@string/app_name"
            android:permission="android.permission.BIND_DEVICE_ADMIN">
            <meta-data
                android:name="android.app.device_admin"
                android:resource="@xml/policies" />
            <intent-filter>
                <action android:name="android.app.action.DEVICE_ADMIN_ENABLED" />
            </intent-filter>
        </receiver>
    </application>
</manifest>

アプリを実行してみよう

それでは、作成したアプリケーションを実行してみましょう。ここでは、実機のAndroidスマートフォンをPCに接続しているものとします。Android Studioからアプリを起動するには、プロジェクト内のアクティビティファイルのいずれかを開き、ツールバーの「Run」アイコンをクリックしてください。デバイス選択のダイアログで接続中のモバイル端末を選ぶと、実機でアプリが起動し、以下のような初期画面が表示されます。