نحو فهرست بیانیه

لیست بیانیه یک فایل یا قطعه کد شده با JSON در یک مکان شناخته شده است.

محل لیست بیانیه

برای اینکه بدانید این لیست باید در کجا ذخیره شود، به ایجاد فهرست بیانیه مراجعه کنید.

نحو

لیست بیانیه یا قطعه شامل یک آرایه JSON از یک یا چند بیانیه وب سایت یا برنامه به عنوان اشیاء JSON است. این اظهارات می توانند به هر ترتیبی باشند. در اینجا نحو کلی آمده است:

[
  {
    "relation": ["relation_string"],
    "target": {target_object}
  } , ...
]
رابطه
آرایه ای از یک یا چند رشته که رابطه اعلان شده در مورد هدف را توصیف می کند. لیست رشته های رابطه تعریف شده را ببینید. مثال: delegate_permission/common.handle_all_urls
هدف
دارایی هدف که این بیانیه در مورد آن اعمال می شود. انواع هدف موجود:

نمونه لیست بیانیه

در اینجا یک نمونه لیست بیانیه وب سایت است که حاوی عباراتی در مورد وب سایت ها و برنامه ها است: http://example.digitalassetlinks.org/.well-known/assetlinks.json

مقیاس دهی به ده ها عبارت یا بیشتر

در برخی موارد، یک مدیر ممکن است بخواهد اظهارات مختلفی را در مورد اهداف مختلف بیان کند، یا ممکن است نیاز به صدور بیانیه هایی از مدیران مختلف برای یک مجموعه از اهداف باشد. برای مثال، یک وب‌سایت ممکن است در دامنه‌های سطح بالای مختلف در هر کشور در دسترس باشد، و همه آنها ممکن است بخواهند درباره یک برنامه تلفن همراه اظهار نظر کنند.

برای این مواقع، شامل کردن عبارات می تواند مفید باشد. با استفاده از این مکانیسم، می‌توانید نشانگرها را از بسیاری از اصلی‌های مختلف در یک مکان مرکزی تنظیم کنید، که دستورات را برای همه اصلی‌ها تعریف می‌کند.

برای مثال، ممکن است تصمیم بگیرید که مکان مرکزی «https://example.com/includedstatements.json» باشد. این فایل را می توان طوری پیکربندی کرد که حاوی همان محتوای مثال های بالا باشد.

برای تنظیم یک اشاره گر از یک وب سایت به فایل شامل، «https://example.com/.well-known/assetlinks.json» را به:

[{
  "include": "https://example.com/includedstatements.json"
}]

برای تنظیم یک اشاره گر از یک برنامه Android به فایل شامل، «res/values/strings.xml» را به:

<resources>
  ...
  <string name="asset_statements">
    [{
      \"include\": \"https://example.com/includedstatements.json\"
    }]
  </string>
</resources>

اطلاعات بیشتر

توضیح دقیق تری از قالب لیست بیانیه و مفاهیم اساسی در سند مشخصات ما وجود دارد.