An interesting thing to note in our Android app is that our app would be making use of open source software developed by Google, which makes our life easier by parsing Eddystone advertisement data. We begin by creating an empty project in the Android Studio by the name of AndroidBeaconScanner. We have already done the project creation multiple times and hence we won't be repeating that here.

Once we have finished creating our empty project, as a first step, we can define some simple user interface as follows:

1. We take a slightly different approach this time. After creating the project, rather initializing the UI as we did earlier, this time we go ahead and include(as described in step 2) the software which is provided "as is" by Google. The advantage of including this software in the very first step is that we won't be running into any build issues later on due to undefined classes.

2. We recommend creating a separate package for the software, which needs to be included as is. This can be done by navigating to File | New | Package, selecting Package and choosing a destination directory which is Java in our case. Please give your package a meaningful name. For simplicity, we just named ours as google as shown in the following screenshot:

3. As shown in the preceding screenshot, we would need the following four files:
   • BluetoothUuid.java
   • ScanRecord.java
   • EddystoneBeacon.java
   • UrlDevice.java

These files are already hosted in Google's Physical Web repository.

We could have also included these files as a part of a bigger package/library, but we do not need everything else. Hence to slim it down, we shall include on only these four files. You can include these files by simply downloading those from GitHub and copying and pasting them in the google package. Please do remember the to change the package name statement at the very start(top of each file) with your own package name as shown in the preceding screenshot. We will explain the purpose of each of these files:

• BluetoothUuid.java: This contains standard service IDs as defined in Bluetooth assigned number documents. It also contains various methods to convert/parse bytes to UUID(s). It is used internally by ScanRecord.java to parse Service UUID(s).

The BluetoothUuid.java file is hosted at Google's Physical Web repository on GitHub: https://github.com/google/physical-web/blob/master/android/PhysicalWeb/app/src/main/java/org/physical_web/physicalweb/ble/BluetoothUuid.java. Alternatively, you can also download it (plus the other three files) prebundled as a part of the current app we are building. The link for the app's code on Github, as always, is provided at the end of this section.

• ScanRecord.java: This represents scan records, containing txPowerLevel, DeviceName, and other relevant information discovered regarding BLE devices found during a BLE scan. The ScanRecord.java file at Google's Physical Web repository https://github.com/google/physical-web/blob/master/android/PhysicalWeb/app/src/main/java/org/physical_web/physicalweb/ble/ScanRecord.java.
• EddystoneBeacon.java: This represents the Eddystone advertisement format. It also contains methods to parse Eddystone advertisement data. The EddystoneBeacon.java file is available at Google's Physical Web repository https://github.com/google/physical-web/blob/master/java/libs/src/main/java/org/physical_web/collection/EddystoneBeacon.java.

In our app, we would be dealing specifically with Eddystone-URL packets.

• UrlDevice.java: This class represents any device, which can broadcast a URL. Since our beacon is advertising a URL, we will need this class to represent it. The UrlDevice.java file is available at Google's Physical Web repository https://github.com/google/physical-web/blob/master/java/libs/src/main/java/org/physical_web/collection/UrlDevice.java.