ย้ายข้อมูลการใช้งานหน้าจอแนะนําไปยัง Android 12 ขึ้นไป

หากคุณใช้หน้าจอแนะนำที่กําหนดเองใน Android 11 หรือเวอร์ชันก่อนหน้า ให้ย้ายข้อมูลแอปไปยัง SplashScreen API เพื่อช่วยตรวจสอบว่าแอปแสดงผลอย่างถูกต้องใน Android 12 ขึ้นไป

ตั้งแต่ Android 12 เป็นต้นไป ระบบจะใช้หน้าจอแนะนำเริ่มต้นของระบบ Android ในการเริ่มตั้งแต่ต้นและเริ่มอุ่นเครื่องสำหรับแอปทั้งหมด โดยค่าเริ่มต้น หน้าจอแนะนำของระบบนี้สร้างขึ้นโดยใช้องค์ประกอบไอคอน Launcher ของแอป และ windowBackground ของ ถ้าเป็นสีเดียว

หากไม่ย้ายข้อมูลแอป ประสบการณ์การเปิดแอปใน Android 12 ขึ้นไปอาจลดลงหรือให้ผลลัพธ์ที่ไม่ต้องการ

  • หากมีการใช้หน้าจอแนะนำที่มีอยู่โดยใช้ธีมที่กำหนดเองซึ่งลบล้าง android:windowBackground ระบบจะแทนที่หน้าจอแนะนำที่กำหนดเองด้วยหน้าจอแนะนำเริ่มต้นของระบบ Android ใน Android 12 ขึ้นไป นี่อาจไม่ใช่จุดประสงค์ของแอปของคุณ ประสบการณ์การใช้งาน

  • หากใช้หน้าจอแนะนำที่มีอยู่โดยใช้ Activity โดยเฉพาะ การเปิดตัวแอปในอุปกรณ์ที่ใช้ Android 12 ขึ้นไปจะส่งผลให้ หน้าจอแนะนำซ้ำ: หน้าจอเริ่มต้นของระบบ ตามด้วยกิจกรรมหน้าจอแนะนำที่มีอยู่

คุณสามารถป้องกันประสบการณ์การใช้งานที่ลดลงหรือไม่ตั้งใจเหล่านี้ได้โดยทําตามกระบวนการย้ายข้อมูลตามที่อธิบายไว้ในเอกสารนี้ หลังจากย้ายข้อมูลแล้ว API จะปรับปรุงเวลาเริ่มต้น ให้การควบคุมประสบการณ์หน้าจอแนะนำอย่างเต็มรูปแบบ และสร้างประสบการณ์การเปิดตัวที่สอดคล้องกันมากขึ้นกับแอปอื่นๆ ในแพลตฟอร์ม

ไลบรารีความเข้ากันได้ของ SplashScreen

คุณสามารถใช้ SplashScreen API ได้โดยตรง แต่เราขอแนะนำให้ใช้ ไลบรารีความเข้ากันได้ของ Androidx SplashScreen แทน ไลบรารีความเข้ากันได้ใช้ SplashScreen API โดยจะเปิดใช้ ความเข้ากันได้แบบย้อนหลัง และสร้างรูปลักษณ์ที่สอดคล้องกันสำหรับหน้าจอเริ่มต้น แสดงใน Android ทุกเวอร์ชัน เอกสารนี้เขียนขึ้นโดยใช้ไลบรารี compat

หากคุณย้ายข้อมูลโดยใช้ SplashScreen API โดยตรงใน Android 11 และรุ่นก่อนหน้า หน้าจอแนะนำจะมีลักษณะเหมือนก่อนการย้ายข้อมูลทุกประการ ตั้งแต่ Android 12 เป็นต้นไป หน้าจอแนะนำจะมีรูปลักษณ์และการใช้งานของ Android 12

หากคุณย้ายข้อมูลโดยใช้ไลบรารีความเข้ากันได้ SplashScreen ระบบจะแสดง หน้าจอแนะนำเดียวกันบน Android ทุกเวอร์ชัน

ย้ายข้อมูลการใช้งานหน้าจอแนะนำ

ทำตามขั้นตอนต่อไปนี้เพื่อย้ายข้อมูลหน้าจอแนะนำที่มีอยู่ ลงใน Android 12 ขึ้นไป

กระบวนการนี้ใช้ได้กับการติดตั้งใช้งานประเภทใดก็ตามที่คุณจะย้ายข้อมูล หากคุณย้ายข้อมูลจาก Activity โดยเฉพาะ ให้ทําตามแนวทางปฏิบัติแนะนำที่อธิบายไว้ในเอกสารนี้เพื่อปรับใช้หน้าจอแนะนำ Activity ที่กําหนดเอง นอกจากนี้ SplashScreen API ยังช่วยลดเวลาในการตอบสนองของการเริ่มต้นที่มาพร้อมกับกิจกรรมหน้าจอแนะนำโดยเฉพาะ

หากต้องการย้ายข้อมูลหน้าจอแนะนำ ให้ทําดังนี้

  1. ในไฟล์ build.gradle เปลี่ยน compileSdkVersion และเพิ่ม ไลบรารีที่สอดคล้องกับ SplashScreen ในทรัพยากร Dependency

    build.gradle

android {
   compileSdkVersion 31
   ...
}
dependencies {
   ...
   implementation 'androidx.core:core-splashscreen:1.0.0-beta02'
}

  2. สร้างธีมที่มีธีมหลักเป็น Theme.SplashScreen กำหนดค่าของ postSplashScreenTheme เป็นธีมที่ Activity ต้องใช้ และกำหนดค่าของ windowSplashScreenAnimatedIcon เป็นภาพวาดหรือภาพเคลื่อนไหวที่วาดได้ แอตทริบิวต์อื่นๆ จะระบุหรือไม่ก็ได้

    <style name="Theme.App.Starting" parent="Theme.SplashScreen">
   <!-- Set the splash screen background, animated icon, and animation
   duration. -->
   <item name="windowSplashScreenBackground">@color/...</item>

   <!-- Use windowSplashScreenAnimatedIcon to add a drawable or an animated
        drawable. One of these is required. -->
   <item name="windowSplashScreenAnimatedIcon">@drawable/...</item>
   <!-- Required for animated icons. -->
   <item name="windowSplashScreenAnimationDuration">200</item>

   <!-- Set the theme of the Activity that directly follows your splash
   screen. This is required. -->
   <item name="postSplashScreenTheme">@style/Theme.App</item>
</style>

    หากต้องการเพิ่มสีพื้นหลังใต้ไอคอน ให้ใช้ธีม Theme.SplashScreen.IconBackground และตั้งค่าแอตทริบิวต์ windowSplashScreenIconBackground

  3. ในไฟล์ Manifest ให้แทนที่ธีมของกิจกรรมเริ่มต้นเป็นธีมที่คุณ สร้างในขั้นตอนก่อนหน้า

    <manifest>
   <application android:theme="@style/Theme.App.Starting">
    <!-- or -->
        <activity android:theme="@style/Theme.App.Starting">
...

  4. เรียก installSplashScreen ในกิจกรรมเริ่มต้นก่อนเรียก super.onCreate()

    Kotlin

    class MainActivity : Activity() {

   override fun onCreate(savedInstanceState: Bundle?) {
       // Handle the splash screen transition.
       val splashScreen = installSplashScreen()

       super.onCreate(savedInstanceState)
       setContentView(R.layout.main_activity)
...

    Java

    public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
         // Handle the splash screen transition.
         SplashScreen splashScreen = SplashScreen.installSplashScreen(this);

         super.onCreate(savedInstanceState);
         setContentView(R.layout.main_activity);
    }
}

installSplashScreen จะแสดงผลออบเจ็กต์หน้าจอแนะนำ ซึ่งคุณอาจใช้เพื่อปรับแต่งภาพเคลื่อนไหวหรือแสดงหน้าจอแนะนำบนหน้าจอเป็นเวลานานขึ้น ดูรายละเอียดเพิ่มเติมเกี่ยวกับการปรับแต่งภาพเคลื่อนไหวได้ที่หัวข้อแสดงหน้าจอแนะนำบนหน้าจอเป็นเวลานานขึ้น และปรับแต่งภาพเคลื่อนไหวสำหรับการปิดหน้าจอแนะนำ

ปรับกิจกรรมหน้าจอแนะนำที่กำหนดเองให้เข้ากับหน้าจอแนะนำ

หลังจากย้ายข้อมูลไปยังหน้าจอแนะนำสำหรับ Android 12 ขึ้นไปแล้ว ให้ตัดสินใจว่าจะดำเนินการอย่างไรกับหน้าจอแนะนำที่กำหนดเองก่อนหน้านี้ Activity คุณมีสิ่งต่อไปนี้ ตัวเลือก:

  • เก็บกิจกรรมที่กําหนดเองไว้ แต่ป้องกันไม่ให้แสดง
  • เก็บกิจกรรมที่กำหนดเองไว้เพื่อเหตุผลการสร้างแบรนด์
  • นํากิจกรรมที่กําหนดเองออกและปรับแอปตามต้องการ

ป้องกันไม่ให้กิจกรรมที่กําหนดเองแสดง

หากหน้าจอแนะนำ Activity ก่อนหน้านี้ของคุณมีไว้สำหรับการกำหนดเส้นทางเป็นหลัก ให้ลองหาวิธีนำออก ตัวอย่างเช่น คุณอาจลิงก์ไปยัง กิจกรรมหรือย้ายไปยังกิจกรรมเอกพจน์ที่มีส่วนประกอบย่อย หากไม่ใช่ คุณสามารถใช้ SplashScreen.setKeepOnScreenCondition เพื่อคงกิจกรรมการกำหนดเส้นทางไว้ แต่ไม่ให้แสดงผล ดังนั้น จะส่งหน้าจอแนะนำไปยังกิจกรรมถัดไป และสนับสนุน การเปลี่ยนแปลง

Kotlin

  class RoutingActivity : Activity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        val splashScreen = installSplashScreen()
        super.onCreate(savedInstanceState)

        // Keep the splash screen visible for this Activity.
        splashScreen.setKeepOnScreenCondition { true }
        startSomeNextActivity()
        finish()
     }
   ...

Java

  public class RoutingActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
      SplashScreen splashScreen = SplashScreen.installSplashScreen(this);

       super.onCreate(savedInstanceState);

       // Keep the splash screen visible for this Activity.
       splashScreen.setKeepOnScreenCondition(() -> true );
       startSomeNextActivity();
       finish();
    }
  ...

เก็บกิจกรรมที่กําหนดเองไว้สําหรับการสร้างแบรนด์

หากต้องการใช้หน้าจอแนะนำก่อนหน้า Activity เพื่อเหตุผลด้านการสร้างแบรนด์ คุณสามารถเปลี่ยนจากหน้าจอแนะนำของระบบเป็นหน้าจอแนะนำที่กำหนดเองActivityได้โดยปรับแต่งภาพเคลื่อนไหวสำหรับการปิดหน้าจอแนะนำ อย่างไรก็ตาม คุณควรหลีกเลี่ยงสถานการณ์นี้ หากเป็นไปได้และใช้ SplashScreen API เพื่อสร้างแบรนด์ให้กับหน้าจอเริ่มต้น

หากต้องการแสดงกล่องโต้ตอบ เราขอแนะนำให้แสดงเหนือกิจกรรมหน้าจอแนะนำแบบกำหนดเองที่แสดงตามมา หรือเหนือกิจกรรมหลักหลังจากหน้าจอแนะนำของระบบ

นำกิจกรรมหน้าจอแนะนำที่กำหนดเองออก

โดยทั่วไป เราขอแนะนำให้นำหน้าจอแนะนำแบบกำหนดเองActivityก่อนหน้าออกทั้งหมดเพื่อไม่ให้มีหน้าจอแนะนำซ้ำกัน เพื่อเพิ่มประสิทธิภาพ และเพื่อลดเวลาในการโหลดหน้าจอแนะนำ มีเทคนิคต่างๆ ที่คุณใช้เพื่อหลีกเลี่ยงการแสดงกิจกรรมหน้าจอแนะนำซ้ำได้

  • ใช้การโหลดแบบเลื่อนเวลาสำหรับคอมโพเนนต์ โมดูล หรือไลบรารี หลีกเลี่ยงการโหลด หรือเริ่มต้นคอมโพเนนต์หรือไลบรารีที่แอปไม่จำเป็นต่อ ทำงานตอนเปิดตัว โหลดภายหลังเมื่อแอปต้องใช้

    หากแอปต้องการคอมโพเนนต์ทำงานอย่างถูกต้องจริงๆ ให้โหลดเมื่อ ที่จำเป็นจริงๆ และไม่ใช่ตอนเปิดตัว หรือใช้ Thread ที่พื้นหลังโหลด หลังจากที่แอปเริ่มทำงาน พยายามทำให้ Application.onCreate() เบาที่สุดเท่าที่จะทำได้

    นอกจากนี้ คุณยังได้รับประโยชน์จากการใช้คลังการเริ่มต้นของแอปเพื่อเริ่มต้นใช้งานคอมโพเนนต์เมื่อแอปพลิเคชันเริ่มต้น ระหว่างการดำเนินการดังกล่าว ให้ตรวจสอบว่ายังคงโหลด โมดูลที่จำเป็นสำหรับกิจกรรมเริ่มต้น และไม่ทำให้เกิดการกระตุกที่ โมดูลที่โหลดแบบ Lazy Loading จะพร้อมใช้งาน

  • สร้างตัวยึดตำแหน่งขณะโหลดข้อมูลจำนวนเล็กน้อยในเครื่อง ใช้เมนู แนวทางการกำหนดธีมที่แนะนำ และระงับการแสดงผลไว้จนกว่าแอปจะ พร้อมแล้ว หากต้องการใช้หน้าจอแนะนำที่เข้ากันได้แบบย้อนหลัง ให้ทำตามขั้นตอนที่ระบุไว้ในแสดงหน้าจอแนะนำบนหน้าจอเป็นเวลานานขึ้น

  • แสดงตัวยึดตำแหน่ง สำหรับการโหลดบนเครือข่ายที่มีระยะเวลาไม่กำหนด ปิดหน้าจอแนะนำและแสดงตัวยึดตำแหน่งสำหรับการโหลดแบบอะซิงโครนัส ลองใช้ภาพเคลื่อนไหวเล็กๆ น้อยๆ ในพื้นที่เนื้อหาที่แสดงสถานะการโหลด ตรวจดูว่าโครงสร้างเนื้อหาที่โหลดตรงกับ โครงสร้างโครงกระดูก เพื่อรองรับการเปลี่ยนผ่านที่ราบรื่นเมื่อเนื้อหาโหลด

  • ใช้การแคช เมื่อผู้ใช้เปิดแอปเป็นครั้งแรก คุณจะแสดง สัญญาณบอกสถานะการโหลดสำหรับองค์ประกอบ UI บางอย่าง ดังที่ปรากฏในรูปต่อไปนี้ ครั้งถัดไปที่ผู้ใช้กลับมาที่แอป คุณสามารถแสดงเนื้อหาที่แคชไว้นี้ขณะโหลดเนื้อหาล่าสุด

รูปที่ 1 กำลังแสดงตัวยึดตำแหน่ง UI