支付宝二维码脱机认证库在android的app下测试过程记录

时间:2022-07-22
本文章向大家介绍支付宝二维码脱机认证库在android的app下测试过程记录,主要内容包括其使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。

今天收到了第三方库(支付宝的二维码脱机认证库,用来脱机验证支付宝的支付二维码),于是兴奋着调用一下试试,如果测试成功,那么做应用自然也没太大问题。

以下为测试过程记录。正好又练手一下在android平台调用动态库及调用第三方动态库的过程。

说明:第三方库要放置于:eclipse工程下libs-armeabi目录下: 包括:libalipayqrcode.so和libposoffline.so,load先后顺序不能错。 其中: libalipayqrcode.so使用ndk编译。稍后附带android.mk文件 libposoffline.so为第三方库(支付宝二维码脱机认证库)

先附个测试结果截图:

过程记录:

android.mk文件如下:

LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) LOCAL_MODULE := alipayqrcode LOCAL_SRC_FILES := alipayqrcode.c LOCAL_LDLIBS := -llog LOCAL_LDFLAGS += libposoffline.so include $(BUILD_SHARED_LIBRARY)

alipayqrcode.c文件内容:

#include <jni.h>
#include <stdio.h>
#include <time.h>
#include <stdlib.h>
#include <string.h>
#include "pos_crypto.h"
#include "alipayqrcode.h"

#include "android/log.h"
#define LOGI(fmt, args...) __android_log_print(ANDROID_LOG_INFO,  LOG_TAG, fmt, ##args)
#define LOGD(fmt, args...) __android_log_print(ANDROID_LOG_DEBUG, LOG_TAG, fmt, ##args)
#define LOGE(fmt, args...) __android_log_print(ANDROID_LOG_ERROR, LOG_TAG, fmt, ##args)

#define LOG_TAG "alipayqrcode"

char print_buf[1024] = {0};

int hex_string_to_bytes(
	char* hex_string, 
	int hex_string_len, 
	unsigned char* bytes, 
	int bytes_len);
char* bytes_to_hex_string(
	char* print_buf, 
	int print_buf_len, 
	const unsigned char* bytes, 
	int len);
void mock_qrcode(unsigned char* qrcode, int* qrcode_len);

unsigned char hex_of_char(char c);

/**
 * 验证二维码例程
 *
 * 本例程演示了如何使用支付宝离线安全库对二维码进行验证
 * 例程中使用了mock_qrcode函数生成一个合法的二维码,并验证该二维码的有效性
 * 
 * */
void check_qrcode_demo(){

	int ret = 0;
	const char* pos_param = NULL;
	int qrcode_len = 0;
	unsigned char qrcode[512] = {0};
	const char* key_list = KEY_LIST;
	const char* card_type_list = CARD_TYPE_LIST;
	LOGI("===========准备数据================n");
	
	LOGI("============进行POS初始化=============n");	
	/**
	 * 请在POS启动时执行POS初始化
	 * 初始化时请提供
	 * 1. 从支付宝处申请得到的秘钥簇 json列表 形式
	 * 2. POS机器支持结算的卡类型 json列表 此处以卡类型 【WH000001 ANT00001】 示例
	 * 注:支持卡类型【ANT00001】代表支持支付宝公交付款
	 */
	ret = init_pos_verify(key_list, card_type_list);
	if(ret != SUCCESS){
		LOGI("初始化POS失败!n");
		switch(ret){
			case ILLEGAL_PARAM:
				LOGI("初始化参数格式错误!请检查参数是否符合json列表格式且各字段正确。n");
			break;
			case NO_ENOUGH_MEMORY:
				LOGI("内存不足,极端错误,请检查程序运行空间是否足够。n");
			break;
			case SYSTEM_ERROR:
				LOGI("系统异常!请联系支付宝技术人员。n");
			break;
			default:
			break;
		}
		return;
	}

	/**
	 * mock一个用户传入的二维码数据qrcode
	 * 开发者应当从扫码头获取用户离线公交码
	 */
	mock_qrcode(qrcode, &qrcode_len);

	/**
	 * pos_param中填入商户pos相关信息 至少包括:
	 *		- pos_id	(商户下唯一的pos号)
	 *		- type		(脱机记录类型,只刷一次闸机计费的场景下,类型为"SINGLE")
	 * 		- subject	(脱机记录标题,建议放入公交路线)
	 *		- record_id	(记录id,商户下本次脱机记录唯一id号,record_id必须保证商户唯一,建议通过POS,时间等信息拼装)
	 * 注意:pos_param的长度不能大于1024字节!
     */
	pos_param = "{"pos_id":"sh001","type":"SINGLE","subject":"bus192","record_id":"sh001_20160514140218_000001"}";
	LOGI("===========准备数据结束================n");
	
	LOGI("===========校验二维码开始================n");
	//拼装验证请求
	VERIFY_REQUEST_V2 verify_request;
	//装入二进制格式的二维码
	verify_request.qrcode = qrcode;
	//装入二进制二维码长度
	verify_request.qrcode_len = qrcode_len;
	//装入pos_param
	verify_request.pos_param = pos_param;
	//装入本次消费金额 如果生成脱机记录时还无法确定消费金额 装入0(单位:分)
	verify_request.amount_cent = AMOUNT_CENT;
	
	VERIFY_RESPONSE_V2 verify_response;
	verify_response.uid = (char*)malloc(17);
	verify_response.uid_len = 17;
	verify_response.record = (char*)malloc(2048);
	verify_response.record_len = 2048;
	verify_response.card_no = (char*)malloc(32);
	verify_response.card_no_len = 32;
	verify_response.card_data = (unsigned char*)malloc(128);
	verify_response.card_data_len = 128;
	verify_response.card_type = (char*)malloc(16);
	verify_response.card_type_len = 16;
	/**
	 * 调用接口验证二维码的有效性
	 */
	ret = verify_qrcode_v2(&verify_request, &verify_response);

	/**
	 * 处理返回的结果
	 */
	if(ret != SUCCESS){
		switch(ret){
			case MALFORMED_QRCODE:
				LOGI("二维码格式错误!请提示用户二维码错误。n");
			break;
			case QRCODE_INFO_EXPIRED:
				LOGI("二维码过期!请提示用户刷新二维码。n");
			break;
			case QRCODE_KEY_EXPIRED:
				LOGI("二维码密钥过期!请提示用户联网后刷新二维码再使用。n");
			break;
			case POS_PARAM_ERROR:
				LOGI("商户传入的pos_param错误,请检查传入的pos_param。n");
			break;
			case QUOTA_EXCEEDED:
				LOGI("单笔额度超限!请提示用户由于额度限制无法过闸机。n");
			break;
			case NO_ENOUGH_MEMORY:
				LOGI("内存不足,极端错误,请检查程序运行空间是否足够。n");
			break;
			case QRCODE_DUPLICATED:
				LOGI("二维码重复!验证失败。n");
			break;
			case SYSTEM_ERROR:
				LOGI("系统异常!请联系支付宝技术人员。n");
			break;
			default:
			break;
		}
		LOGI("二维码校验结束!验证失败,不放行!n");
		LOGI("===========验证二维码例程 结束================n");
		free(verify_response.uid);
		free(verify_response.record);
		free(verify_response.card_no);
		free(verify_response.card_data);
		free(verify_response.card_type);
		return;
	}
	LOGI("从二维码中获取到的uid: %sn", verify_response.uid);
	LOGI("验证成功后,返还的脱机记录: %sn", verify_response.record);
	LOGI("二维码中的卡类型为: %sn",verify_response.card_type);
	LOGI("二维码中的卡号为: %sn", verify_response.card_no);

	bytes_to_hex_string(print_buf, sizeof(print_buf), 
						verify_response.card_data, verify_response.card_data_len);
	LOGI("二维码中的二进制卡数据(hex string形式):%sn", print_buf);

	/**
	 * 1.商户可以根据uid判断是否为同一用户重复交易
	 */
	
	/**
	 * 2.商户可以根据qrcode判断是否为重复二维码
	 *   此判断也可以放在校验二维码前执行,商户可以自行选择
	 */

	/**
	 * 3.商户需要根据卡类型、卡号、卡数据 综合判断该卡的合法性、以及是否受理该卡
	 * 请商户保留 可受理 的脱机记录
	 */
	 
	free(verify_response.uid);
	free(verify_response.record);
	free(verify_response.card_no);
	free(verify_response.card_data);
	free(verify_response.card_type);

	LOGI("验证成功,请放行!n");
	LOGI("===========验证二维码例程 结束================n");
}


/**
 * mock一个用户传入的二维码数据qrcode
 * 此处是使用QRCODE_HEX_DATA mock出的用户二维码数据 
 * 开发者测试时请使用二维码工具生成一个新的QRCODE_HEX_DATA后
 * 装入宏定义中QRCODE_HEX_DATA,再执行mock
 */
void mock_qrcode(unsigned char* qrcode, int* qrcode_len){
	
	char qrcode_hex[] = QRCODE_HEX_DATA;
	int qrcode_hex_len = strlen(qrcode_hex);
	*qrcode_len = strlen(qrcode_hex)/2;
	hex_string_to_bytes(qrcode_hex, qrcode_hex_len, qrcode, *qrcode_len);
}
/**
* 字节数组转hex格式字符串
* @param print_buf: 十六进制字符串buffer
* @param print_buf_len: 十六进制字符串buffer长度
* @param bytes: 二进制数据
* @param bytes_len: 二进制数据长度
*/
char* bytes_to_hex_string(
	char* print_buf, 
	int print_buf_len, 
	const unsigned char* bytes, 
	int len) {

	int i = 0;

	/**
	* 入参校验
	*/ 
	if(print_buf == NULL || bytes == NULL || (len * 2 + 1) > print_buf_len) {
		return NULL;
	}

	for(i = 0; i < len; i++) {
		print_buf[i * 2] = g_hex_map_table[(bytes[i] >> 4) & 0x0F];
		print_buf[i * 2 + 1] = g_hex_map_table[(bytes[i]) & 0x0F];
	}
	/**
	* 填充字符串结束符
	*/
	print_buf[i * 2] = '';
	/**
	* 返回目标地址
	*/
	return print_buf;
}
/**
* hex格式字符串转字节数组
* @param hex_string: 十六进制字符串
* @param hex_string_len: 十六进制字符串长度
* @param bytes: 二进制数据存储空间
* @param bytes_len: 目标空间长度
*/
int hex_string_to_bytes(
	char* hex_string, 
	int hex_string_len, 
	unsigned char* bytes, 
	int bytes_len) {
	
	int i = 0;

	/**
	* 校验十六进制字符串长度必须偶数,并且目标存储空间必须足够存放转换后的二进制数据
	*/
	if((hex_string_len % 2 != 0) || (bytes_len * 2 < hex_string_len)) {
		return -1;
	}
	
	for(i = 0; i < hex_string_len; i += 2) {
		bytes[i/2] = ((hex_of_char(hex_string[i]) << 4) & 0xF0) | 
					(hex_of_char(hex_string[i + 1]) & 0x0F);
	}
	return 1;
}
/**
* hex格式char转二进制
*/
unsigned char hex_of_char(char c) {
	unsigned char tmp = 0;
	if(c >= '0' && c <= '9') {
		tmp = (c - '0');
	}
	else if(c >= 'A' && c <= 'F') {
		tmp = (c - 'A' + 10);
	}
	else if(c >= 'a' && c <= 'f') {
		tmp = (c - 'a' + 10);
	}
	return tmp;
}


int test( void) {
	check_qrcode_demo();
	return 0;
}


jint JNICALL jni_check_qrcode_test(void)
{
	LOGD("%s>>> ..%s..%d..enter",LOG_TAG,__FUNCTION__,__LINE__);
	test();
	return 0;
}


//定义批量注册的数组,是注册的关键部分
static const JNINativeMethod gMethods[] = { 
    {"qrcode_test",        /* func2是在java中声明的native函数名 */
     "()I",          /* "()V"是函数的签名,可以通过javah获取。*/
     (void*)jni_check_qrcode_test
    }
};

// extern "C" {
	JNIEXPORT jint JNI_OnLoad(JavaVM* vm,void *reserved)
{
	JNIEnv *env =NULL;
	jint result = -1;
	static const char* kClassName="com/example/ndktest/Test";
	jclass clazz;
	
	LOGD("%s>>> ..%s..%d..enter",LOG_TAG,__FUNCTION__,__LINE__);
	
	if( (*vm)->GetEnv(vm,(void**)&env,JNI_VERSION_1_4) != JNI_OK )
	{
		return result;
	}

	clazz = (*env)->FindClass(env,kClassName);
	if( clazz == NULL )
	{
		return -1;
	}

	if( (*env)->RegisterNatives( env,clazz, gMethods, sizeof(gMethods)/sizeof(gMethods[0]) ) != JNI_OK )
	{
		return -1;
	}

	return JNI_VERSION_1_4;
}
// }

需要注意的地方,定义批量注册的数组,是注册的关键部分。其中的 "()I" 知道是干啥的吗?因为我这的qrcode_test不带参数,所以签名是()I,

如果我的qrcode_test方法带两个参数,这里签名应该是 (II)I, 否则java层通过JNI调用时,会报找不到方法的。

JNI_Onload函数,当启动程序的时候,会加载库文件,就会调用这个函数。接着在onload函数中,注册了nativemethods。 methods数组中第一个和第三个参数比较好理解,那么第二个参数呢?其实第二个参数可以参考头文件,一模一样拉过来就好了。其中的意思就是()里的表示函数的参数,()表示没有参数,(II)表示两个参数,都是int。后面跟的Ljava/lang/String表示返回值是String类型的,I表示的是int类型。

还有个地方要注意了,包名一定不能错,我的是 static const char* kClassName="com/example/ndktest/Test"

另外一点需注意的是应用层注意load顺序,先load第三方库,再load自己的库....

至此,调用第三方支付宝库的测试就完成了,总共尝试了三种不同的测试方法。(本来测一个就够了,就是要举一反三,多练习练习)

在linux_x86平台下的测试过程在另一篇中记录。

单纯的在android平台通过adb shell调用过程,在另一篇文章中记录。