標籤`生成，用於建立導航動作和設定參數
- `{Fragment名稱 + Args}`: 根據目的地是否需要接收參數來生成，用於在目的地 Fragment 中獲取參數
---
▼宣告依賴項
---
>[!Warning]注意事項
>SafeArgs 需要分別在 頂層 build.gradle 和 應用程式層的 build.gradle 寫入依賴項
到官網尋找依賴項[AndroidDeveloper--Safe Args
](https://developer.android.com/guide/navigation/use-graph/safe-args?hl=zh-tw#enable)
圖解
```groovy=
//頂層模組的依賴項
buildscript {
repositories {
google()
}
dependencies {
val nav_version = "2.8.0"
classpath("androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version")
}
}
```
```groovy=
//應用程式層級的依賴項，二擇一即可。
//產生適合Kotlin 模組的 Kotlin 語言程式碼
plugins {
id("androidx.navigation.safeargs.kotlin")
}
//產生適合 Java 或混用 Java 及 Kotlin 模組的 Java 語言程式碼
plugins {
id("androidx.navigation.safeargs")
}
```
>延伸閱讀:[Android筆記–SafeArgs補充–為甚麼SafeArgs的依賴要用到ClassPath?
](https://hackmd.io/@9YAtszqXS2OLNZOrLY_-Jg/android_Navigation_SafeArgs_AdditionalInformation)
---
▼簡單使用
---
SafeArgs 的使用要點主要有三部分:
1. 導航圖設定
首先到導航圖中設定目標 Fragment 所要接收的參數
---
1. 到導航圖中選擇一個要作為目標的 Fragment，在 Attribute 面板中的 Arguments 中點選加號後進行設定
2. 設定完成後，Arguments 就會被附加到導航圖中的目標 Fragment 的設定之中
>[!Important]
>- 這個設定是多對一的，也就是說，所有「目的地為此 Fragment 的 起點 Fragment」，都必須要提交我們設定在目標 Fragment 上的 Argument 才能過來
>- 例如: 只要是以 FragmentB 為目標的 Fragment(例如: FragmentA、C、D)，都必須提供一個 String 參數 nameBBB，否則會出現錯誤
2. 在起點 Fragment 中放入參數
在起點 Fragment 中呼叫 「XXXDirections」，並選擇對應的 「actionXXToXX」，然後填入 「步驟1」 中所設計的參數，完成後，可將此物件提供給 NavController 當作 [Action](https://hackmd.io/@9YAtszqXS2OLNZOrLY_-Jg/android_navigation#NavigationGraphBasicProperties) 使用
---
```kotlin=
class FragmentA : Fragment() {
private lateinit var binding: FragmentABinding
override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?,savedInstanceState: Bundle?): View? {
binding = FragmentABinding.inflate(inflater, container, false)
val navController = findNavController()
val action = FragmentADirections.actionFragmentAToFragmentB("String A To B")
binding.button.setOnClickListener {
navController.navigate(action)
}
return binding.root
}
}
```
3. 在目標 Fragment 中接收參數
呼叫 「Fragment 名 + Args 物件」，然後使用其中的 fromBundle(requireArguments()) 來獲取 Arg，再從 Arg 中獲取需要的參數
---
```kotlin=
class FragmentB : Fragment() {
private lateinit var binding: FragmentBBinding
override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?,avedInstanceState: Bundle?): View? {
binding = FragmentBBinding.inflate(inflater, container, false)
val arg = FragmentBArgs.fromBundle(requireArguments())
binding.tvBB.text = arg.nameBBB
return binding.root
}
}
```
如果我 A 有設定 Argument，然後從 B 來 popUpToA 的話，這樣 A 可以拿到資料嗎?
---
不行，因為 popUpTo 的本質是清空導航堆疊的一部分，並彈回到指定的目的地，這個操作並不涉及資料傳遞。