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

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



Под катом вы увидите, что именно я сделал. Но сразу скажу, что профи 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. В этом случае всё начало работать нормально.

UPD:
Ссылки для закачивания новых драйверов (актуально на 30.01.2017):
Центр загрузки
Архив с используемыми драйверами
Поделиться с друзьями
-->

Комментарии (15)


  1. kxl
    27.01.2017 19:58

    К AndroidStudio то зачем? чеки на исходники пробивать? ;)


    1. Snakecatcher
      27.01.2017 22:12

      Кхм… Вообще-то о проекте, идёт речь.
      В предыдущей статье упоминал, что официальное руководство рассматривает подключение к проекту, только для Eclipse.


  1. real_mista
    27.01.2017 22:08

    compile files('src/main/libs/paycardlib.jar')

    на какие модели расчитана эта строка?


    1. Snakecatcher
      27.01.2017 22:10

      Если честно, не знаю. У разработчиков, пока не нашел ничего по данному поводу.


  1. eisaev
    30.01.2017 09:53

    Как же просто выглядит адаптация ПО под ФЗ-54: обновил либы, поправил опечатки, переименовал интерфейс и готово! Я разработчик кроссплатформенного кассового ПО со своими реализациями низкоуровневой работы с ККТ разных производителей. Так и тянет тех, кто не вникал в изменения в законодательство, разогнать розовое облачко и рассказать какой там Адъ, боль и некомпетентный бред написан, который приходится реализовывать на уровнях ниже, чем описано в данной статье.


    1. Snakecatcher
      30.01.2017 23:48

      Если вы напишете статью об этом, то я (да и не только я, наверное) с большим интересом прочитал бы её.


      1. eisaev
        31.01.2017 11:28

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


        1. Snakecatcher
          31.01.2017 11:36

          Нужно-нужно. )) Для усиления действия совести, могу являться во сне, и укоризненно молчать :)


  1. fivehouse
    30.01.2017 10:02

    Ох как же далек путь вот от этого:

    fptr.BeginDocument();
    fptr.put_Caption(«ТЕСТ.ТЕСТ.ТЕСТ.»);
    fptr.put_ReceiptLinespacing(255);
    fptr.put_ReceiptBrightness(15);
    fptr.put_Alignment(2);
    fptr.PrintString();
    fptr.EndDocument();
    до реального чека. А если еще надо печатать/создавать чеки параллельно на 2-3 кассы…


    1. Snakecatcher
      30.01.2017 10:06

      Согласен с вами.
      Но это просто тестовый проект, в котором делюсь своим опытом подключения драйверов от АТОЛ`а.


    1. Snakecatcher
      31.01.2017 09:33

      Кстати, обращаюсь к вам с тем же предложением, как и к уважаемому eisaev. Думаю если вы напишете об этом статью, то она окажется интересна многим.
      Лично передо мной стояла задача только подцепить драйвера в проект, и протестировать. Поэтому глубоко не вникал в вопрос. Настройкой, и печатью чеков занимается другой человек.


  1. agorlov
    30.01.2017 12:45

    Дайте пожалуйста ссылку на обновленный драйвер и документацию.
    Раньше находил их в разделе поддержка и старый вариант у меня есть, новый не смог найти.


    1. Snakecatcher
      30.01.2017 13:37
      +1

      Смотрите в центре разработки:
      Центр загрузки

      Мне дали ссылку вот на такой архив, который я и использовал:
      Архив


    1. Snakecatcher
      30.01.2017 13:42

      Добавил еще, в конец статьи.


      1. agorlov
        30.01.2017 15:13

        Спасибо.