3DSView 项目教程

1. 项目的目录结构及介绍

3DSView 项目的目录结构如下：

3DSView/
├── 3DSViewSample/
├── gradle/
│   └── wrapper/
├── .gitignore
├── LICENSE
├── README.md
├── build.gradle
├── gradle.properties
├── gradlew
├── gradlew.bat
├── maven.properties
├── settings.gradle

目录介绍

• 3DSViewSample/: 包含项目的示例代码。
• gradle/wrapper/: 包含 Gradle 包装器文件，用于确保项目使用特定版本的 Gradle。
• .gitignore: Git 忽略文件，指定哪些文件和目录不需要被版本控制。
• LICENSE: 项目的许可证文件，本项目使用 Apache-2.0 许可证。
• README.md: 项目的说明文档。
• build.gradle: 项目的构建脚本。
• gradle.properties: Gradle 属性文件，包含 Gradle 构建的配置属性。
• gradlew: Gradle 包装器脚本，用于 Unix 系统。
• gradlew.bat: Gradle 包装器脚本，用于 Windows 系统。
• maven.properties: Maven 属性文件，包含 Maven 构建的配置属性。
• settings.gradle: Gradle 设置文件，包含项目的多模块配置。

2. 项目的启动文件介绍

项目的启动文件主要是 3DSViewSample/src/main/java/eu/livotov/labs/android/d3s/sample/MainActivity.java。

MainActivity.java

package eu.livotov.labs.android.d3s.sample;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import eu.livotov.labs.android.d3s.D3SView;

public class MainActivity extends AppCompatActivity
{
    @Override
    protected void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        D3SView d3sView = findViewById(R.id.d3sview);
        d3sView.setAuthorizationListener(new D3SView.D3SViewAuthorizationListener()
        {
            @Override
            public void onAuthorizationCompleted(String md, String paRes)
            {
                // Handle authorization completion
            }

            @Override
            public void onAuthorizationFailed(String error)
            {
                // Handle authorization failure
            }
        });

        // Invoke authorization
        d3sView.authorize("MD", "PaReq", "ACS_URL");
    }
}

文件介绍

• MainActivity.java: 这是项目的启动 Activity，负责初始化 D3SView 组件并设置授权监听器。通过调用 authorize 方法启动 3D Secure 授权流程。

3. 项目的配置文件介绍

项目的配置文件主要包括 build.gradle 和 gradle.properties。

build.gradle

apply plugin: 'com.android.application'

android {
    compileSdkVersion 30
    defaultConfig {
        applicationId "eu.livotov.labs.android.d3s.sample"
        minSdkVersion 16
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation 'eu.livotov.labs.android:3DSView:x.y.z@aar'
}

文件介绍

• build.gradle: 这是项目的构建脚本，定义了 Android 应用的配置，包括编译 SDK 版本、应用 ID、最小和目标 SDK 版本、版本代码和名称，以及依赖项。

gradle.properties

org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
android.useAndroidX=true
android.enableJetifier=true

文件介绍

• gradle.properties: