From 12dff95c68bc5d5f8fc5413a88d4a6265eb2a084 Mon Sep 17 00:00:00 2001
From: Nathan Yang <yangxuguang3@huawei.com>
Date: Mon, 28 Jul 2025 10:39:20 +0800
Subject: [PATCH] feat: add
 OH_AbilityRuntime_StartSelfUIAbilityWithReceivingPid

Signed-off-by: Nathan Yang <yangxuguang3@huawei.com>
---
 .../ability_runtime/application_context.h     | 36 +++++++++++++++++++
 .../libability_runtime.ndk.json               |  4 +++
 2 files changed, 40 insertions(+)

diff --git a/AbilityKit/ability_runtime/application_context.h b/AbilityKit/ability_runtime/application_context.h
index ed62cf402..37faee6b1 100644
--- a/AbilityKit/ability_runtime/application_context.h
+++ b/AbilityKit/ability_runtime/application_context.h
@@ -294,6 +294,42 @@ AbilityRuntime_ErrorCode OH_AbilityRuntime_StartSelfUIAbility(AbilityBase_Want *
 AbilityRuntime_ErrorCode OH_AbilityRuntime_StartSelfUIAbilityWithStartOptions(AbilityBase_Want *want,
     AbilityRuntime_StartOptions *options);
 
+/**
+ * @brief Starts self UIAbility with start options and receives the process ID.
+ *
+ * @permission {@code ohos.permission.NDK_START_SELF_UI_ABILITY}
+ * @param want The arguments passed to start self UIAbility.
+ * For details, see {@link AbilityBase_Want}.
+ * @param options The start options passed to start self UIAbility.
+ * For details, see {@link AbilityRuntime_StartOptions}.
+ * @param pid The process ID of the started UIAbility.
+ * @return Returns {@link ABILITY_RUNTIME_ERROR_CODE_NO_ERROR} if the call is successful.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_PERMISSION_DENIED} if the caller has no correct permission.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_PARAM_INVALID} if the arguments provided is invalid.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_NOT_SUPPORTED} if the device does not support starting self uiability.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_NO_SUCH_ABILITY} if the target ability does not exist.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_INCORRECT_ABILITY_TYPE} if the ability type is incorrect.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_CROWDTEST_EXPIRED} if the crowdtesting application expires.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_WUKONG_MODE} if the ability cannot be started in Wukong mode.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_CONTROLLED} if the app is controlled.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_EDM_CONTROLLED} if the app is controlled by EDM.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_CROSS_APP} if the caller tries to start a different application.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_INTERNAL} if internal error occurs.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_NOT_TOP_ABILITY} if the caller is not foreground process.
+ * Returns {@link ABILITY_RUNTIME_ERROR_VISIBILITY_SETTING_DISABLED} if setting visibility is disabled.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_MULTI_APP_NOT_SUPPORTED}
+ *          if the app clone or multi-instance is not supported.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_INVALID_APP_INSTANCE_KEY} if the app instance key is invalid.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_UPPER_LIMIT_REACHED} if the number of app instances reached the limit.
+ * Returns {@link ABILITY_RUNTIME_ERROR_MULTI_INSTANCE_NOT_SUPPORTED} if the multi-instance is not supported.
+ * Returns {@link ABILITY_RUNTIME_ERROR_CODE_APP_INSTANCE_KEY_NOT_SUPPORTED}
+ *          if the APP_INSTANCE_KEY cannot be specified.
+ * For details, see {@link AbilityRuntime_ErrorCode}.
+ * @since 21
+ */
+AbilityRuntime_ErrorCode OH_AbilityRuntime_StartSelfUIAbilityWithReceivingPid(AbilityBase_Want *want,
+    AbilityRuntime_StartOptions *options, int32_t &pid);
+
 #ifdef __cplusplus
 } // extern "C"
 #endif
diff --git a/AbilityKit/ability_runtime/libability_runtime.ndk.json b/AbilityKit/ability_runtime/libability_runtime.ndk.json
index 6790d7d68..380a016c8 100644
--- a/AbilityKit/ability_runtime/libability_runtime.ndk.json
+++ b/AbilityKit/ability_runtime/libability_runtime.ndk.json
@@ -178,5 +178,9 @@
 	{
         "first_introduced": "20",
         "name": "OH_AbilityRuntime_ApplicationContextGetResourceDir"
+    },
+    {
+        "first_introduced": "21",
+        "name": "OH_AbilityRuntime_StartSelfUIAbilityWithReceivingPid"
     }
 ]
\ No newline at end of file
-- 
Gitee