В свете обновления законодательства (ФЗ-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».
Пример тестового приложения:
<?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>
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')
}
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)
real_mista
27.01.2017 22:08compile files('src/main/libs/paycardlib.jar')
на какие модели расчитана эта строка?Snakecatcher
27.01.2017 22:10Если честно, не знаю. У разработчиков, пока не нашел ничего по данному поводу.
eisaev
30.01.2017 09:53Как же просто выглядит адаптация ПО под ФЗ-54: обновил либы, поправил опечатки, переименовал интерфейс и готово! Я разработчик кроссплатформенного кассового ПО со своими реализациями низкоуровневой работы с ККТ разных производителей. Так и тянет тех, кто не вникал в изменения в законодательство, разогнать розовое облачко и рассказать какой там Адъ, боль и некомпетентный бред написан, который приходится реализовывать на уровнях ниже, чем описано в данной статье.
Snakecatcher
30.01.2017 23:48Если вы напишете статью об этом, то я (да и не только я, наверное) с большим интересом прочитал бы её.
eisaev
31.01.2017 11:28Наверное нужно пообещать написать данный опус, иначе точно никогда не доберусь из-за занятости и лени, а так глядишь совесть замучает. Правда не уверен, что чтиво будет сильно техническим, т.к. с интересными алгоритмическими решениями там не густо, но в целом опыт крайне занимательный.
Snakecatcher
31.01.2017 11:36Нужно-нужно. )) Для усиления действия совести, могу являться во сне, и укоризненно молчать :)
fivehouse
30.01.2017 10:02Ох как же далек путь вот от этого:
fptr.BeginDocument();
до реального чека. А если еще надо печатать/создавать чеки параллельно на 2-3 кассы…
fptr.put_Caption(«ТЕСТ.ТЕСТ.ТЕСТ.»);
fptr.put_ReceiptLinespacing(255);
fptr.put_ReceiptBrightness(15);
fptr.put_Alignment(2);
fptr.PrintString();
fptr.EndDocument();Snakecatcher
30.01.2017 10:06Согласен с вами.
Но это просто тестовый проект, в котором делюсь своим опытом подключения драйверов от АТОЛ`а.
Snakecatcher
31.01.2017 09:33Кстати, обращаюсь к вам с тем же предложением, как и к уважаемому eisaev. Думаю если вы напишете об этом статью, то она окажется интересна многим.
Лично передо мной стояла задача только подцепить драйвера в проект, и протестировать. Поэтому глубоко не вникал в вопрос. Настройкой, и печатью чеков занимается другой человек.
agorlov
30.01.2017 12:45Дайте пожалуйста ссылку на обновленный драйвер и документацию.
Раньше находил их в разделе поддержка и старый вариант у меня есть, новый не смог найти.Snakecatcher
30.01.2017 13:37+1Смотрите в центре разработки:
Центр загрузки
Мне дали ссылку вот на такой архив, который я и использовал:
Архив
kxl
К AndroidStudio то зачем? чеки на исходники пробивать? ;)
Snakecatcher
Кхм… Вообще-то о проекте, идёт речь.
В предыдущей статье упоминал, что официальное руководство рассматривает подключение к проекту, только для Eclipse.