Подключаем ККМ АТОЛ к AndroidStudio (обновление к ФЗ-54)

в 13:29, , рубрики: android studio, атол, ККМ, Разработка под android

Добрый день. Прошлым летом, мне необходимо было подключить ККМ АТОЛ, к проекту в AndroidStudio. Успешно справившись с поставленной задачей, я опубликовал пост на Хабре, чтобы облегчить путь тем, кто пойдёт моим путём: Подключаем ККМ АТОЛ к AndroidStudio.

В свете обновления законодательства (ФЗ-54), для ККМ АТОЛ были выпущены обновлённые драйвера, которые для подключения требуют несколько иного подхода, чем описанный ранее.

Подключаем ККМ АТОЛ к AndroidStudio (обновление к ФЗ-54) - 1

Под катом вы увидите, что именно я сделал. Но сразу скажу, что профи Android-разработки, ничего интересного для себя, наверное не найдут, а для новичков типа меня — немного облегчит путь разработки.

Для подключения обновлённых драйверов, были сделаны следующие шаги:

1) Удалил старый модуль из проекта: File — Project Structure — выбираем старый модуль из раздела Modules, и нажимаем на красный минус;
2) Добавил новый модуль: File — New — Import Module — ищем папку (в предоставленной папке, у меня: Драйверы_торгового_оборудования/android/jar) FptrLibRes и добавляем её в проект;
3) Далее, как и в предыдущей статье добавляем в jniLibs (путь: app/src/main), папки armeabi и armeabi-v7a;
4) Добавляем в папку libs (путь: app/src/main) — jar-файлы: fptrlib.jar, fptrproxylib.jar, paycardlib.jar, usblib.jar Правой кнопкой мыши щелкните по jar-файлам, и выберите «Add As Library»;
5) Вносим изменения в gradle (привожу пример из тестового проекта, который был создан ещё для прошлой статьи):

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.4.0'
    compile project(':fptrRes')
    compile files('src/main/libs/fptrproxylib.jar')
    compile files('src/main/libs/paycardlib.jar')
    compile files('src/main/libs/usblib.jar')
    compile files('src/main/libs/fptrlib.jar')
}

6) Из манифеста удаляем строки (если они были, как в прошлом тестовом проекте):

        <activity android:name="com.atol.drivers.fptr.settings.SettingsActivity"
            android:label="Свойства ККМ"
            android:windowSoftInputMode="adjustPan">
            <intent-filter>
                <action android:name="android.intent.action.VIEW"/>
            </intent-filter>
        </activity>
        <activity android:name="com.atol.drivers.fptr.settings.DeviceListActivity"
            android:configChanges="orientation|keyboardHidden"
            android:label="Выбор устройства"/>

7) В коде появятся ошибки. Для исправления меняем:

fptr = new IFptr();
на
fptr = new Fptr();

Также выдаст ошибку на операторы содержащие слова «Reciept». Их нужно поменять на «Receipt».

Пример тестового приложения:

Файл AndroidManifest

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="ru.kkm_test">
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
    <uses-permission android:name="android.permission.BLUETOOTH"/>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

Файл gradle

apply plugin: 'com.android.application'

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.2"

    defaultConfig {
        applicationId "ru.kkm_test"
        minSdkVersion 14
        targetSdkVersion 22
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.4.0'
    compile project(':fptrRes')
    compile files('src/main/libs/fptrproxylib.jar')
    compile files('src/main/libs/paycardlib.jar')
    compile files('src/main/libs/usblib.jar')
    compile files('src/main/libs/fptrlib.jar')
}

Файл MainActivity

import android.content.Intent;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Toast;

import com.atol.drivers.fptr.Fptr;
import com.atol.drivers.fptr.IFptr;
import com.atol.drivers.fptr.settings.SettingsActivity;
public class MainActivity extends AppCompatActivity {
    IFptr fptr = null;
    public String TAG = "atol";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        try{
            fptr = new Fptr();
            fptr.create(this);
        } catch (NullPointerException ex){
            fptr = null;
        }
    }

    public void onClick(View view){
        switch (view.getId()){
            case R.id.button:
                Intent intent = new Intent(this, SettingsActivity.class);
                intent.putExtra(SettingsActivity.DEVICE_SETTINGS, fptr.get_DeviceSettings());
                startActivityForResult(intent, 1);

                break;
        }
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        if(requestCode == 1){
            if(data!=null && data.getExtras()!=null){
                String settings  = data.getExtras().getString(SettingsActivity.DEVICE_SETTINGS);
                Toast.makeText(this, settings, Toast.LENGTH_LONG).show();
                printSlip(settings);

            }
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        fptr.destroy();
    }

    public void printSlip(String settings){
        if(fptr == null) {
            try {
                fptr = new Fptr();
                fptr.create(this);

            } catch (NullPointerException ex) {
                fptr = null;
            }
        }
        fptr.put_DeviceSettings(settings);
        fptr.put_DeviceEnabled(true);
        fptr.Beep();

        Log.d(TAG, fptr.GetStatus()+" status");

        fptr.put_UserPassword("30");
        fptr.put_Mode(1);

        if(fptr.SetMode()<0){
            Log.d(TAG, "Ошибка: "+ fptr.get_ResultCode());
        }

        fptr.BeginDocument();
        fptr.put_Caption("ТЕСТ.ТЕСТ.ТЕСТ.");
        fptr.put_ReceiptLinespacing(255);
        fptr.put_ReceiptBrightness(15);
        fptr.put_Alignment(2);
        fptr.PrintString();
        fptr.EndDocument();

        fptr.put_Mode(2);
        fptr.SetMode();
        fptr.PrintFooter();
    }
}

Далее, работаем по официальному руководству.

Засим позвольте откланяться. Надеюсь кому-то это позволит сохранить время и нервы. Если у кого-то есть замечания и подсказказки, с большим удовольствием их выслушаю.

P.S.: недавно досталась возможность потестировать своё приложение на устройстве с API23. При создании и чтении файла, постоянно ловил исключение. Так я столкнулся с новой политикой безопасности в отношении разрешений. Разобраться в этом мне помогла замечательная статья от OneeL: Android runtime permissions. Почему, зачем и как.

Прикинув, что возможности API23, в моём приложении вроде пока ни к чему, я понизил targetSdkVersion до 22. В этом случае всё начало работать нормально.

Автор: Snakecatcher

Источник

* - обязательные к заполнению поля


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js