!21556 [同步4.0-beta2]cert getSerialNumber接口修改

Merge pull request !21556 from HaixiangW/OpenHarmony-4.0-Beta2

zh-cn/application-dev/reference/apis/js-apis-cert.md

@@ -553,12 +553,16 @@ cryptoCert.createX509Cert(encodingBlob, function (error, x509Cert) {
 });
 ```
 
-### getSerialNumber
+### getSerialNumber<sup>(deprecated)</sup>
 
 getSerialNumber() : number
 
 表示获取X509证书序列号。
 
+> **说明：**
+>
+> 从API version 9开始支持，从API version 10开始废弃，建议使用[getCertSerialNumber](#getcertserialnumber10)替代。
+
 **系统能力：** SystemCapability.Security.Cert
 
 **返回值**：
@@ -589,6 +593,48 @@ cryptoCert.createX509Cert(encodingBlob, function (error, x509Cert) {
 });
 ```
 
+### getCertSerialNumber<sup>10+</sup>
+
+getCertSerialNumber() : bigint
+
+表示获取X509证书序列号。
+
+**系统能力：** SystemCapability.Security.Cert
+
+**返回值**：
+
+| 类型   | 说明               |
+| ------ | ------------------ |
+| bigint | 表示X509证书序列号 |
+
+**错误码：**
+
+| 错误码ID | 错误信息                                          |
+| -------- | ------------------------------------------------- |
+| 19020002 | runtime error.                                    |
+
+**示例：**
+
+```js
+import cryptoCert from '@ohos.security.cert';
+
+// 证书二进制数据，需业务自行赋值
+let encodingData = null;
+let encodingBlob = {
+    data: encodingData,
+    // 根据encodingData的格式进行赋值，支持FORMAT_PEM和FORMAT_DER
+    encodingFormat: cryptoCert.EncodingFormat.FORMAT_PEM
+};
+cryptoCert.createX509Cert(encodingBlob, function (error, x509Cert) {
+    if (error != null) {
+        console.log("createX509Cert failed, errCode: " + error.code + ", errMsg: " + error.message);
+    } else {
+        console.log("createX509Cert success");
+        let serialNumber = x509Cert.getCertSerialNumber();
+    }
+});
+```
+
 ### getIssuerName
 
 getIssuerName() : DataBlob

zh-cn/application-dev/security/cert-guidelines.md

@@ -34,7 +34,7 @@
 | X509Cert        | getPublicKey() : cryptoFramework.PubKey                       | 获取证书公钥                               |
 | X509Cert        | checkValidityWithDate(date: string) : void                   | 校验证书有效期                              |
 | X509Cert        | getVersion() : number                                        | 获取证书版本                                 |
-| X509Cert        | getSerialNumber() : number                                   | 获取证书序列号                               |
+| X509Cert        | getCertSerialNumber() : bigint<sup>10+</sup>| 获取证书序列号                               |
 | X509Cert        | getIssuerName() : DataBlob                                   | 获取证书颁发者名称                           |
 | X509Cert        | getSubjectName() : DataBlob                                  | 获取证书主体名称                             |
 | X509Cert        | getNotBeforeTime() : string                                  | 获取证书有效期起始时间                       |