Android - 共享首選項

Android 提供了許多儲存應用程式資料的方法。其中一種方法稱為共享首選項 (Shared Preferences)。共享首選項允許您以鍵值對的形式儲存和檢索資料。

為了使用共享首選項，您必須呼叫 `getSharedPreferences()` 方法，該方法返回一個指向包含首選項值的檔案的 SharedPreference 例項。

SharedPreferences sharedpreferences = getSharedPreferences(MyPREFERENCES, Context.MODE_PRIVATE);	

第一個引數是鍵，第二個引數是模式。除了私有模式外，還有其他可用的模式，如下所示：

您可以使用 `SharedPreferences.Editor` 類在共享首選項中儲存內容。您將呼叫 `SharedPreference` 例項的 `edit` 方法，並將其接收在編輯器物件中。其語法如下：

Editor editor = sharedpreferences.edit();
editor.putString("key", "value");
editor.commit();

除了 `putString` 方法外，編輯器類中還有其他方法允許操作共享首選項中的資料。它們列示如下：

示例

此示例演示了共享首選項的使用。它顯示一個帶有文字欄位的螢幕，當應用程式關閉時，其值將被儲存，並在再次開啟時恢復。

要試驗此示例，您需要在一個實際裝置上執行它，或者按照以下步驟開發應用程式後：

以下是修改後的 `MainActivity.java` 檔案的內容。

package com.example.sairamkrishna.myapplication;

import android.content.Context;
import android.content.SharedPreferences;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {
   EditText ed1,ed2,ed3;
   Button b1;
	
   public static final String MyPREFERENCES = "MyPrefs" ;
   public static final String Name = "nameKey";
   public static final String Phone = "phoneKey";
   public static final String Email = "emailKey";
	
   SharedPreferences sharedpreferences;

   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);

      ed1=(EditText)findViewById(R.id.editText);
      ed2=(EditText)findViewById(R.id.editText2);
      ed3=(EditText)findViewById(R.id.editText3);

      b1=(Button)findViewById(R.id.button);
      sharedpreferences = getSharedPreferences(MyPREFERENCES, Context.MODE_PRIVATE);

      b1.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            String n  = ed1.getText().toString();
            String ph  = ed2.getText().toString();
            String e  = ed3.getText().toString();

            SharedPreferences.Editor editor = sharedpreferences.edit();

            editor.putString(Name, n);
            editor.putString(Phone, ph);
            editor.putString(Email, e);
            editor.commit();
            Toast.makeText(MainActivity.this,"Thanks",Toast.LENGTH_LONG).show();
         }
      });
   }

}

以下是修改後的主活動檔案 `res/layout/activity_main.xml` 的內容。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout 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" android:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   android:paddingBottom="@dimen/activity_vertical_margin" tools:context=".MainActivity">
   
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Shared Preference "
      android:id="@+id/textView"
      android:layout_alignParentTop="true"
      android:layout_centerHorizontal="true"
      android:textSize="35dp" />
      
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Tutorials Point"
      android:id="@+id/textView2"
      android:layout_below="@+id/textView"
      android:layout_centerHorizontal="true"
      android:textSize="35dp"
      android:textColor="#ff16ff01" />
      
   <EditText
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/editText"
      android:layout_below="@+id/textView2"
      android:layout_marginTop="67dp"
      android:hint="Name"
      android:layout_alignParentRight="true"
      android:layout_alignParentEnd="true"
      android:layout_alignParentLeft="true"
      android:layout_alignParentStart="true" />
      
   <EditText
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/editText2"
      android:layout_below="@+id/editText"
      android:layout_alignParentLeft="true"
      android:layout_alignParentStart="true"
      android:layout_alignParentRight="true"
      android:layout_alignParentEnd="true"
      android:hint="Pass" />
      
   <EditText
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/editText3"
      android:layout_below="@+id/editText2"
      android:layout_alignParentLeft="true"
      android:layout_alignParentStart="true"
      android:layout_alignParentRight="true"
      android:layout_alignParentEnd="true"
      android:hint="Email" />
      
   <Button
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Save"
      android:id="@+id/button"
      android:layout_below="@+id/editText3"
      android:layout_centerHorizontal="true"
      android:layout_marginTop="50dp" />
      
</RelativeLayout>

以下是修改後的檔案 `res/values/strings.xml` 的內容。

<resources>
   <string name="app_name">My Application</string>
</resources>

以下是預設檔案 `AndroidManifest.xml` 的內容。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.sairamkrishna.myapplication" >
   
   <application
      android:allowBackup="true"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:theme="@style/AppTheme" >
      
      <activity
         android:name=".MainActivity"
         android:label="@string/app_name" >
         
         <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
         
      </activity>
      
   </application>
</manifest>

讓我們嘗試執行您的應用程式。我假設您已將您的實際 Android 手機裝置連線到您的計算機。要從 Android Studio 執行應用程式，請開啟專案中的一個活動檔案，然後單擊工具欄中的執行 圖示。在啟動應用程式之前，Android Studio 將顯示以下視窗，讓您選擇要在其中執行 Android 應用程式的位置。

選擇您的移動裝置作為選項，然後檢查您的移動裝置，它將顯示以下螢幕：

現在只需在欄位中輸入一些文字。例如，我輸入了一些隨機名稱和其他資訊，然後單擊儲存按鈕。

現在，當您按下儲存按鈕時，文字將儲存在共享首選項中。現在按後退按鈕並退出應用程式。現在再次開啟它，您將看到您之前寫入的所有文字都回到了您的應用程式中。