初始化配置

概述

初始化是使用 txnet 库的第一步，必须在调用任何其他函数之前完成。初始化时需要提供应用ID、加密密钥、版本信息等基础配置。

配置结构体

txnet_config

typedef struct {
    const char* app_id;
    const char* server_public_key;
    const char* client_private_key;
    int version_code;
    const char* version_name;
    const char* login_save_path;
} txnet_config;

字段说明

字段	类型	必填	说明
app_id	const char*	是	应用唯一标识，由服务端分配
server_public_key	const char*	是	服务器 RSA 公钥，PEM 格式
client_private_key	const char*	是	客户端 RSA 私钥，PEM 格式
version_code	int	是	版本号，整数形式
version_name	const char*	是	版本名称（如 "1.0.0"）
login_save_path	const char*	否	登录码本地保存路径

函数

txnet_init

void txnet_init(const txnet_config* config);

功能: 初始化 txnet 库，设置基础配置信息。

调用时机: 程序启动时，在调用任何其他 txnet 函数之前。

参数:

参数	类型	说明
config	const txnet_config*	配置结构体指针

注意事项:

• 必须首先调用，否则其他函数行为未定义
• 配置中的字符串指针在调用后可以释放，库内部会复制
• 重复调用会覆盖之前的配置

示例

#include "txnet.h"

const char* SERVER_PUBLIC_KEY = R"(-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...
-----END PUBLIC KEY-----)";

const char* CLIENT_PRIVATE_KEY = R"(-----BEGIN PRIVATE KEY-----
MIIEvQIBADANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...
-----END PRIVATE KEY-----)";

int main() {
    txnet_config config = {
        .app_id = "my_app_001",
        .server_public_key = SERVER_PUBLIC_KEY,
        .client_private_key = CLIENT_PRIVATE_KEY,
        .version_code = 100,
        .version_name = "1.0.0",
        .login_save_path = "/data/local/tmp/my_app.login"
    };
    
    txnet_init(&config);
    
    // 后续操作...
    return 0;
}