模板工程

一个具有良好开发框架的银行模板项目。它基于Newland SDK实现了各种金融交易。

演示

[demo.apk] 是 BankTemplate，而 [platform.apk] 是一个本地模拟平台。通过这两个apk，可以在开发POS上执行模拟交易。

操作：模拟应用 -> （服务已开启）配置 -> 保存 -> 对话框确认。然后，可以在BankTemplate上执行交易。

注意：模拟平台apk只能在开发POS上执行。

Gradle和环境

Android Studio	Gradle插件版本	Gradle版本	Android SDK
2023.2.1	8.0.2	8.0	33

如果打开项目时出现错误，请升级Gradle到最新版本。（Android Studio->帮助->检查更新）

为了方便项目开发，BankTemplate的gradle 进行了一些修改，与原生版本存在以下差异：

• SDK版本
• 库依赖
• 生成的APK名称
• 签名配置
• 命名空间（以前是AndroidManifest.xml中的package）

具体内容，请参见 **[Gradle配置]

UI

BankTemplate开发了基本的主题、元素颜色和尺寸。

它自定义了常见视图和组件，并使用了多个Lottie动画，适应不同屏幕。

具体内容，请参见 [UI]

逻辑流程

当你在启动器上点击BankTemplate时，应用程序将根据以下流程处理：

[App] 被调用。App将初始化应用程序的基本参数。这个步骤在一个单独的线程上执行，不会影响UI进程。这些参数是应用程序需要初始化的前半部分参数。

//初始化应用程序中的数据
public class App extends BaseApplication {
    @Override
    public void onCreate() {
      	...
         BaseApplication.SINGLE_EXECUTOR.execute(() -> {
            SelfCheckHelper.initAppConfig(this);
        });
    }
}

然后，[MainActivity] 将被启动。它将在与App相同的单线程上初始化剩余参数。这样可以使参数的初始化按顺序执行。BankTemplate的所有屏幕都在Fragment中实现。

public class MainActivity extends BaseActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
       	...
        BaseApplication.SINGLE_EXECUTOR.execute(() -> {
            SelfCheckHelper.initDevice(this);
            ...
            mSupportDelegate.switchContent(MainFragment.newInstance());
        });
        ...
    }
}

所以[MainFragment]将由MainActivity打开以显示主菜单。MainFragment有一个ViewPager来显示[MenuFragment]。MenuFragment包含主菜单。如果一个屏幕无法显示所有菜单项，你可以滑动屏幕到下一个屏幕或进入一个[SubMenuFragment]。

public class MainFragment extends BaseFragment {
   ...
    private void initView() {
       ...
        List<MenuFragment> childFragments = createMenuFragments(items.subList(1, items.size()));
        binding.viewPager.setAdapter(new FragmentStateAdapter(this) {
            @NonNull
            @Override
            public Fragment createFragment(int position) {
                return childFragments.get(position);
            }

            @Override
            public int getItemCount() {
                return childFragments.size();
            }
        });
        ...
    }
	...
    @Override
    public void onResume() {
        super.onResume();
        if (MainMenu.getInstance().isChanged()) {
            initView();
        }
    }
}

当点击主菜单项时，[TransActivity]将被打开。然后，TransActivity将开始交易。

public class TransActivity extends BaseActivity {
	...
    private void transact() {
        ...
        AbstractTrans trans;
        try {
            Class<? extends AbstractTrans> clz = TransUtils.getTrans(pubBean.getTransType());
            if (clz == null) {
                LoggerUtils.e("Transaction class is null.");
                intent.putExtra(TransTag.MESSAGE, getString(R.string.core_transaction_result_no_such_trans));
                intent.putExtra(TransTag.RESULT_CODE, ResultCode.FL);
                setResult(RESULT_CANCELED, intent);
                finish();
                return;
            }
            LoggerUtils.d("Instantiate transaction: " + clz);
            trans = clz.newInstance();
        } catch (IllegalAccessException | InstantiationException e) {
            ...
            finish();
            return;
        }
        ...
        trans.init(this, pubBean);
        trans.transact((success) -> {
            ...
            finish();
        });
    }
	...
}

交易

每个交易处理由一个交易类控制。交易类将在TransActivity启动时调用，并在交易类完成后TransActivity结束。

具体内容，请参见 [交易] 。

应用设置

[Settings]是一个用于应用设置的交易。当Settings执行时，它将启动[SettingsActivity]。

SettingsActivity需要密码。有两个密码用于不同的设置。

• 201003 -> 供应商设置。此密码在代码中是固定的。供应商设置用于紧急处理。
• 000000-> 管理员/商户设置。此密码可以在设置中修改或通过core/src/main/asset/default_params.ini进行修改。此设置用于商户配置。

Newland SDK

BankTemplate将所有与SDK库相关的API封装在[sdk_helper]模块中。

它包括以下SDK：

ISO8583

[ISO8583.md] 介绍了如何打包8583数据。