Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

ทดสอบ App Link

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

หากต้องการทดสอบไฟล์ใบแจ้งยอดที่มีอยู่ คุณสามารถใช้เครื่องมือเครื่องมือสร้างและทดสอบรายการใบแจ้งยอดได้

ส่วนต่อไปนี้อธิบายวิธีทดสอบการยืนยัน App Link ด้วยตนเอง หากต้องการ คุณสามารถทดสอบการยืนยันจากเครื่องมือ Play Deep Link หรือผู้ช่วย App Link ของ Android Studio ได้

ยืนยันรายชื่อโฮสต์ที่จะยืนยัน

เมื่อทดสอบ คุณควรยืนยันรายการโฮสต์ที่เชื่อมโยงซึ่งระบบควรยืนยันสำหรับแอปของคุณ ทำรายการ URL ทั้งหมดซึ่งตัวกรอง Intent ที่เกี่ยวข้องมีแอตทริบิวต์และองค์ประกอบต่อไปนี้

แอตทริบิวต์ android:scheme ที่มีค่าเป็น http หรือ https
android:host แอตทริบิวต์ที่มีรูปแบบ URL ของโดเมน
องค์ประกอบการดำเนินการ android.intent.action.VIEW
องค์ประกอบหมวดหมู่android.intent.category.BROWSABLE

ใช้รายการนี้เพื่อตรวจสอบว่ามีไฟล์ JSON ของลิงก์เนื้อหาดิจิทัล (Digital Asset Links) ในแต่ละโฮสต์และโดเมนย่อยที่ระบุชื่อหรือไม่

ยืนยันไฟล์ลิงก์เนื้อหาดิจิทัล (Digital Asset Links)

สำหรับแต่ละเว็บไซต์ ให้ใช้ Digital Asset Links API เพื่อยืนยันว่าไฟล์ JSON ของ Digital Asset Links ได้รับการโฮสต์และกำหนดอย่างถูกต้อง

https://digitalassetlinks.googleapis.com/v1/statements:list?
   source.web.site=https://<var>domain.name</var>:<var>optional_port</var>&amp;
   relation=delegate_permission/common.handle_all_urls

สำหรับ Dynamic App Link คุณยังตรวจสอบส่วนขยายความสัมพันธ์ได้ด้วย

https://digitalassetlinks.googleapis.com/v1/statements:list?source.web.site=https://www.example.com&relation=delegate_permission/common.handle_all_urls&return_relation_extensions=true

ตรวจสอบนโยบายลิงก์

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

adb shell dumpsys package domain-preferred-apps

คำสั่งต่อไปนี้จะทำงานเหมือนกัน

adb shell dumpsys package d

คำสั่งจะแสดงรายการผู้ใช้หรือโปรไฟล์แต่ละรายการที่กำหนดไว้ในอุปกรณ์ โดยมีส่วนหัวในรูปแบบต่อไปนี้

App linkages for user 0:

หลังจากส่วนหัวนี้ เอาต์พุตจะใช้รูปแบบต่อไปนี้เพื่อแสดงรายการการตั้งค่าการจัดการลิงก์สำหรับผู้ใช้รายนั้น

Package: com.android.vending
Domains: play.google.com market.android.com
Status: always : 200000002

ข้อมูลนี้จะระบุว่าแอปใดเชื่อมโยงกับโดเมนใดสำหรับผู้ใช้รายนั้น

Package - ระบุแอปตามชื่อแพ็กเกจที่ประกาศไว้ใน ไฟล์ Manifest
Domains - แสดงรายการโฮสต์ทั้งหมดที่แอปนี้จัดการลิงก์บนเว็บ โดยใช้ช่องว่างเป็นตัวคั่น
Status - แสดงการตั้งค่าการจัดการลิงก์ปัจจุบันสำหรับแอปนี้ แอปที่ ผ่านการยืนยันและมี android:autoVerify="true" ในไฟล์ Manifest จะแสดงสถานะเป็น always ตัวเลขฐานสิบหก หลังสถานะนี้เกี่ยวข้องกับบันทึกของระบบ Android เกี่ยวกับ ค่ากำหนดการลิงก์แอปของผู้ใช้ ค่านี้ไม่ได้ระบุว่าการยืนยันสำเร็จหรือไม่

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

ตัวอย่างการทดสอบ

หากต้องการให้การยืนยัน App Link สำเร็จ ระบบต้องยืนยันแอปของคุณกับเว็บไซต์แต่ละแห่งที่คุณระบุในตัวกรอง Intent ที่กำหนดซึ่งเป็นไปตามเกณฑ์สำหรับ App Link ได้ ตัวอย่างต่อไปนี้แสดงการกำหนดค่าไฟล์ Manifest ที่มี App Link หลายรายการที่กำหนดไว้

<activity android:name="MainActivity">
        <intent-filter android:autoVerify="true">
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.DEFAULT" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="https" />
            <data android:scheme="https" />
            <data android:host="www.example.com" />
            <data android:host="mobile.example.com" />
        </intent-filter>
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="https" />
            <data android:host="www.example2.com" />
        </intent-filter>
    </activity>

    <activity android:name="SecondActivity">
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.DEFAULT" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="https" />
            <data android:host="account.example.com" />
        </intent-filter>
    </activity>

      <activity android:name="ThirdActivity">
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.DEFAULT" />
            <data android:scheme="https" />
            <data android:host="map.example.com" />
        </intent-filter>
        <intent-filter>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="market" />
            <data android:host="example.com" />
        </intent-filter>
      </activity>

</application>

รายชื่อโฮสต์ที่แพลตฟอร์มจะพยายามยืนยันจากไฟล์ Manifest ก่อนหน้ามีดังนี้

www.example.com
mobile.example.com
www.example2.com
account.example.com

รายชื่อโฮสต์ที่แพลตฟอร์มจะไม่พยายามยืนยันจาก ไฟล์ Manifest ก่อนหน้ามีดังนี้

map.example.com (it does not have android.intent.category.BROWSABLE)
market://example.com (it does not have either an "http" or "https" scheme)

ดูข้อมูลเพิ่มเติมเกี่ยวกับรายการใบแจ้งหนี้ได้ที่การสร้างรายการใบแจ้งหนี้

วินิจฉัยการแก้ลิงก์ด้วยแฟล็ก debug-link

ตั้งแต่ Android 17 เป็นต้นไป คุณสามารถใช้แฟล็ก --debug-link กับคำสั่ง Activity Manager (am start) เพื่อวินิจฉัยวิธีที่ระบบแก้ไข URL ที่เฉพาะเจาะจง เครื่องมือนี้จะแสดงรายละเอียดของแอปที่เข้าเกณฑ์ซึ่งตรงกับความตั้งใจ พร้อมด้วยกฎที่เฉพาะเจาะจงจากไฟล์ Manifest ของแอปและไฟล์ assetlinks.json (สำหรับ App Link แบบไดนามิก) ที่ได้รับการประเมินระหว่างการแก้ไข

หากต้องการทดสอบการเปลี่ยนเส้นทางลิงก์สำหรับ URL ที่เฉพาะเจาะจง ให้เรียกใช้คำสั่งต่อไปนี้ในหน้าต่างเทอร์มินัล

adb shell am start --debug-link -a android.intent.action.VIEW -d "https://xyz.com/foo"

เอาต์พุตการวินิจฉัยจะพิมพ์ภายใต้ส่วนหัว App Link Resolution Debug และมีส่วนต่อไปนี้เพื่อช่วยให้คุณเข้าใจกระบวนการแก้ไข

รายละเอียดเป้าหมาย: ระบุแอปที่ตรงกันแต่ละแอปตามชื่อแพ็กเกจและกิจกรรมเป้าหมาย
การจับคู่ตัวกรอง Intent (AndroidManifest.xml): แสดงแอตทริบิวต์แบบคงที่ ใดในตัวกรอง Intent ของ Manifest (เช่น scheme, host, path, pathPrefix หรือ pathPattern) ที่ตรงกับ URI
การยืนยัน App Link: แสดงสถานะการยืนยันโดเมนปัจจุบัน (เช่น STATE_SUCCESS)
App Link แบบไดนามิก: หากแอปใช้กฎการจับคู่ App Link แบบไดนามิกในไฟล์ assetlinks.json ส่วนนี้จะแสดงกฎทั้งหมดที่ได้รับการประเมินเทียบกับ URI กฎแต่ละข้อจะระบุตัวกรอง URI ที่ตรงกัน (เช่น คำนำหน้าหรือรูปแบบเส้นทาง) และฟิลด์ allow ดังนี้
- allow = 0: กฎอนุญาต/รวม (allow: true) หากกฎนี้ ตรงกัน ระบบจะอนุญาตให้แอปเปิด URI
- allow = 1: กฎบล็อก/ยกเว้น (allow: false / exclude: true) หากกฎนี้ตรงกัน ระบบจะป้องกันไม่ให้แอปเปิด URI
- หมายเหตุ: สตริงตัวกรองที่ว่างเปล่า (filter =) แสดงคำนำหน้าเส้นทางที่ว่างเปล่า ซึ่งตรงกับเส้นทางทั้งหมดภายใต้โดเมน (ทำหน้าที่เป็น ไวลด์การ์ดหรือการจับทั้งหมด)

ตัวอย่างเอาต์พุตการแก้ไขข้อบกพร่อง

พิจารณาแอป (com.example.xyzapp) ที่เชื่อมโยงกับโดเมน https://xyz.com ซึ่งกำหนดกฎแบบไดนามิกในไฟล์ assetlinks.json เพื่อ ยกเว้น /foo* ขณะที่อนุญาตเส้นทางอื่นๆ ทั้งหมด

[
  {
    "relation": [
      "delegate_permission/common.handle_all_urls"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "com.example.xyzapp",
      "sha256_cert_fingerprints": ["..."]
    },
    "relation_extensions": {
      "delegate_permission/common.handle_all_urls": {
        "dynamic_app_link_components": [
          {"/": "/foo*", "exclude": true},
          {"/": "*"}
        ]
      }
    }
  }
]

เมื่อวินิจฉัย URL https://xyz.com/foo โดยใช้ --debug-link ให้ทำดังนี้

adb shell am start --debug-link -a android.intent.action.VIEW -d "https://xyz.com/foo"

คำสั่งจะแสดงรายละเอียดการวินิจฉัยต่อไปนี้

--- App Link Resolution Debug ---

URI: https://xyz.com/foo
Resolution: Ambiguous (Multiple apps or Browser fallback)
This usually happens when multiple apps can handle the link and no default is set.

All Matching Candidates:

Target:
  Package: com.example.xyzapp
  Activity: com.example.xyzapp.MainActivity

  Intent Filter Match (AndroidManifest.xml)
    Scheme: 'https' matched android:scheme="https"
    Host: 'xyz.com' matched android:host="xyz.com"

App Link Verification:
  Verification status: STATE_SUCCESS
  Dynamic App Links:
    -> Matched Rule 0: UriRelativeFilterGroup { allow = 1, uri_filters = {UriRelativeFilter { uriPart = PATH, patternType = PREFIX, filter = /foo }},  }
    -> Matched Rule 1: UriRelativeFilterGroup { allow = 0, uri_filters = {UriRelativeFilter { uriPart = PATH, patternType = PREFIX, filter =  }},  }

Target:
  Package: org.chromium.webview_shell
  Activity: org.chromium.webview_shell.WebViewBrowserActivity

  Intent Filter Match (AndroidManifest.xml)
    Scheme: 'https' matched android:scheme="https"

---------------------------------

Starting: Intent { act=android.intent.action.VIEW dat=https://xyz.com/foo }

ในตัวอย่างนี้ ระบบได้ประเมินกฎ App Link แบบไดนามิก 2 รายการจาก assetlinks.json

กฎ 0 (allow = 1, filter = /foo): สร้างจาก {"/": "/foo*", "exclude": true} ซึ่งเป็นกฎการยกเว้น (allow: false) ที่บล็อก URL ที่ขึ้นต้นด้วยคำนำหน้าเส้นทาง /foo
กฎ 1 (allow = 0, filter =): สร้างจาก {"/": "*"} ซึ่งเป็น กฎการรวม (allow: true) ที่มีคำนำหน้าเส้นทางว่าง (filter =) ซึ่งตรงกับเส้นทางทั้งหมดภายใต้ xyz.com (ครอบคลุมทั้งหมด)

วิธีการแก้ไขในสถานการณ์นี้

ทั้งกฎ 0 และกฎ 1 ตรงกับ URL https://xyz.com/foo
ระบบจะประเมินกฎของ App Link แบบไดนามิกตามลำดับจากบนลงล่าง (กฎแรกที่ตรงกันจะชนะ)
เนื่องจากกฎ 0 ปรากฏเป็นรายการแรกในรายการข้อความและเป็นกฎการยกเว้น (allow = 1) กฎนี้จึงมีความสำคัญเหนือกว่ากฎการอนุญาตทั่วไป (กฎ 1)
ดังนั้นระบบจึงยกเว้นแอปจากการจัดการ https://xyz.com/foo ซึ่งทำให้ระบบกลับไปใช้เบราว์เซอร์หรือแสดงกล่องโต้ตอบการแยกความกำกวม