You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: NfcTool/README.md
+10-57Lines changed: 10 additions & 57 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
# NFC Tag Reading and Writing Sample
1
+
# A Compendium of NFC Samples
2
2
3
3
The purpose of this application is to demonstrate how to use selected
4
4
BlackBerry 10 NFC APIs. The Release History section gives details of
@@ -19,81 +19,34 @@ the [Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0.html).
19
19
20
20
21
21
**Release History**
22
+
23
+
***V4** - Added support for sending ISO7816 APDUs and handling Transaction Events
22
24
***V3.1** - Modified for Beta 3 release compatibility
23
25
***V3** - Added ability to emulate virtual NDEF Tags
24
-
***V3** - Added ability to emulate virtual NDEF Tags
25
26
***V2.1** - Refactored to exploit features in BlackBerry Dev Alpha Device 10.0.6
26
27
***V2** - Added transfer of vCard using SNEP
27
28
***V1** - Reading and Writing NDEF tags
28
29
29
30
**Known Issues**
30
-
1. Reading a tag when the app is not running causes the app to be launched but the event log is not automatically switched to. Read tag with app already running
31
-
and the event log is correctly shown.
32
-
2. Work is in progress to add functionality relating to UICC secure element APIs. This is not yet complete and so the code is not yet connected to the UI.
31
+
32
+
None.
33
33
34
34
**Dependencies**
35
35
36
-
1. BlackBerry Dev Alpha Device Software **10.0.9**
37
-
2. BlackBerry 10 Native SDK **10.0.9**
36
+
1. BlackBerry Dev Alpha Beta 3 Device Software **10.0.9**
37
+
1. BlackBerry 10 Native SDK **10.0.9**
38
38
39
39
**How to Build NfcTool**
40
40
41
-
We took the decision to distribute only the contents of the **"src/"** and **"assets/"**
42
-
directories along with the **"NfcTool.pro"** file with this example.
43
-
44
-
We've found it to be the more reliable technique whilst the meta-data associated with
45
-
an NDK project is still subject to change between versions of the NDK. You are less
46
-
likely to run into issues with a project if you create it as a new empty project
47
-
in your workspace and copy files into it rather than import a project with a
48
-
structure from an older version of the IDE.
49
-
50
-
Here's what you should do:
51
-
52
-
* Create a new empty Cascades C++ project in your workspace called **"NfcTool"**
53
-
***File** > **New** > BlackBerry Cascades C++ Project
54
-
* Enter Project Name: **NfcTool** > **Next**
55
-
* Select: **Standard empty project** > **Finish**
56
-
* You've now got a clean project set up appropriately for your version of the IDE
57
-
* Delete the **"app.cpp"** and **"app.hpp"** files from the project's **"src/"** directory -- we don't need them
58
-
* Replace contents of the **"src/"** and **"assets/"** directories in the project by the contents of **"src/"** and **"assets/"* from this repo
59
-
* Replace **"NfcTool.pro"** in the project by the one in this repo
60
-
* This file just ensure that the **"libnfc.so"** and **"libnfc_bps.so"** libraries are available to the build process since they're not included in the library path by default.
61
-
* You'll also now have a **"bar-descriptor.xml"** which is correct for your verion of the IDE.
62
-
* You need to make sure it's populated with your own **Debug Token**
63
-
* Also, if you want to ensure that the application has the correct icon and startup splash screen (I'm sure you do!) open the **"bar-descriptor.xml"** file, select the **"Application"** tab and choose:
64
-
***"assets/images/generic\_tag.png"** as the **Icon image**
65
-
***"assets/images/splash\_landscape.png"** and **"assets/images/splash.png"** as the **"Landscape"** and **"Portrait"** splash screen images respectively.
66
-
* In BlackBerry Dev Alpha Device Software 10.0.6 the **Invocation Framework** is now used to register an application to be notified when an NFC NDEF tag is presented to the device. You need to add this registration to your **"bar-descriptor.xml"** file. The registration that we use in this sample application is shown in the code section below.
67
-
68
-
Add this stanza to your **"bar-descriptor.xml"** file at the end, just before the closing **"</qnx>"** tag. The meaning of the various fields is described in the article that accompanies this code sample.
Simply Import the project into a workspace in your NDK. Of course you should review the project after it's been imported paying particular attention to the settings in the **bar-descriptor.xml** file. It should be changed to reflect values in the **<author>** and **<authorId>** elements that are appropriate for you.
90
42
91
43
**But I don't want to build it myself**
92
44
93
45
If you don't want to build this sample application yourself we've included a
94
46
pre-build and signed BAR files for each version. You can find them in the
95
-
folder "installable-bar-files" as follows:
47
+
folder **"/installable-bar-files"** as follows:
96
48
49
+
***NfcTool-4\_0\_0\_2.bar** -- Signed BAR file for Version 4.0 (V4.0) of the application ( requires BlackBerry Dev Alpha Device Beta 3 Software 10.0.9 )
97
50
***NfcTool-3\_0\_0\_51.bar** -- Signed BAR file for Version 3.0 (V3.0) of the application ( requires BlackBerry Dev Alpha Device Software 10.0.6 )
98
51
***NfcTool-2\_1\_0\_2.bar** -- Signed BAR file for Version 2.1 (V2.1) of the application ( requires BlackBerry Dev Alpha Device Software 10.0.6 )
99
52
***NfcTool-2\_0\_0\_1.bar** -- Signed BAR file for Version 2 (V2) of the application ( requires BlackBerry Dev Alpha Device Software 10.0.4 )
0 commit comments