Category: Technology

Laravel 5: create route group that is only available during testing (Middleware)

Today I needed to protect a group of routes from everything except my testing environment. I need to run PHPUnit tests that depend on certain routes, but I don’t want those routes to be available anywhere else. I’ll share in this blog post what I did to get what I need.

Assumptions in this tutorial:

You already have Laravel 5 installed on your computer and you are running the app in “testing” mode (e.g. PHPUnit testing)

Introduction

In Laravel, Middleware filters requests that are coming into our application. One of the pre-made Middleware in Laravel 5.2 is Authenticate, which looks like this:

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Support\Facades\Auth;

class Authenticate
{
    /**
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @param  string|null  $guard
     * @return mixed
     */
    public function handle($request, Closure $next, $guard = null)
    {
        if (Auth::guard($guard)->guest()) {
            if ($request->ajax() || $request->wantsJson()) {
                return response(‘Unauthorized.’, 401);
            } else {
                return redirect()->guest(‘login’);

            }
        }

        return $next($request);
    }
}

<?php

namespace App\Http\Middleware;

use Closure;

use Illuminate\Support\Facades\Auth;

class Authenticate

{

/**

* Handle an incoming request.

* @param \Illuminate\Http\Request $request

* @param \Closure $next

* @param string|null $guard

* @return mixed

public function handle($request, Closure $next, $guard = null)

{

if (Auth::guard($guard)->guest()) {

if ($request->ajax() || $request->wantsJson()) {

return response(‘Unauthorized.’, 401);

} else {

return redirect()->guest(‘login’);

}

return $next($request);

}

Inside the handle() method, it checks if the request is using AJAX -or- is asking for JSON, and if either condition returns TRUE, it blocks access and returns ‘Unauthorized’ as response. Otherwise, client is redirected to the ‘login’ route, which should happen when client is requesting via web browser.

What I did to make my grouped routes available only in testing environment (in my case, when running PHPUnit) was create a new Middlewave. I’ll show you how. 🙂

Create a new file under Http/Middleware and name it TestingEnvOnly.php

<?php
namespace App\Http\Middleware;
use \App\Http\Controllers\API\ApiLogsController;
use Closure;
use \Log;
/**
 * Check if phpunit is the one running the app
 */
class TestingEnvOnly 
{
    /**
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @return mixed
     */
    public function handle($request, Closure $next)
    {
        if(env(‘APP_ENV’) == “testing”){
            return $next($request);
        } else {
            return response(‘Unavailable.’, 401);
        }
    }
}

<?php

namespace App\Http\Middleware;

use \App\Http\Controllers\API\ApiLogsController;

use Closure;

use \Log;

/**

* Check if phpunit is the one running the app

class TestingEnvOnly

{

/**

* Handle an incoming request.

* @param \Illuminate\Http\Request $request

* @param \Closure $next

* @return mixed

public function handle($request, Closure $next)

{

if(env(‘APP_ENV’) == “testing”){

return $next($request);

} else {

return response(‘Unavailable.’, 401);

}

In the handle method, we check if app environment is set to testing, and if so, we allow the request to access the requested route. Otherwise, the request should fail and repond with ‘Unavailable’.

Now, let’s register this Middleware to Http/Middleware. Add the following to the $routeMiddleware array:

‘testing’ => \App\Http\Middleware\TestingEnvOnly::class

1	‘testing’ => \App\Http\Middleware\TestingEnvOnly::class

It’s time to add a testing-only route:

<?php

Route::group([‘middleware’ => [‘testing’]], function(){
    Route::get(“testing_env_only”, function(){
        echo “This should be visible only for testing environment”;
    });
});

<?php

Route::group([‘middleware’ => [‘testing’]], function(){

Route::get(“testing_env_only”, function(){

echo “This should be visible only for testing environment”;

});

If you use PHPUnit like I do, you can test our new Middleware by creating this test method:

<?php
    public function testNewMiddleware(){
        $content = $this->call(“GET”, “/api/v1/testing_env_only”)->getContent();
        var_dump($content);
    }

<?php

public function testNewMiddleware(){

$content = $this->call(“GET”, “/api/v1/testing_env_only”)->getContent();

var_dump($content);

}

I’m only using var_dump so that we can easily see the printed string response which should say “This should be visible only for testing environment” when you run PHPUnit.

Now, in your web browser, visit the route your set for /api/v1/testing_env_only. It should say ‘Unauthorized’.

Here’s how the files I edited in Laravel look like now:

I’m using Laravel 5.2 and these are codes I uploaded at Gist

July 22, 2016

Laravel 5: activate API token guard and print “Unauthorized” instead of login redirect

In Laravel 5, I wrap my API routes in a route group like this:

Route::group([‘middleware’ => [‘auth:api’,’throttle’]], function() {
    // API routes here
});

Route::group([‘middleware’ => [‘auth:api’,‘throttle’]], function() {

// API routes here

});

Notice that I use auth:api and throttle on my middleware array.

auth:api turns on the auth middleware with API token as guard, while throttle activates rate limiter for APIs.

To get started with API token authentication, you may read https://gistlog.co/JacobBennett/090369fbab0b31130b51.

I followed the same tutorial to set mine up, but had this issue: Upon using invalid api_token or no token at all, I am redirected to the /login route, which in my case is a currently nonexistent route.

As instructed by the guide, I already edited my app/Http/Middleware/Authenticate.php file to add the || $request->wantsJson() condition, but my API routes still redirected to /login route upon detection of invalid api_token.

The solution

What I did was add another condition: || $guard == "api"

And now, my app/Http/Middleware/Authenticate.php file looks like this:

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Support\Facades\Auth;

class Authenticate
{
    /**
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @param  string|null  $guard
     * @return mixed
     */
    public function handle($request, Closure $next, $guard = null)
    {
        if (Auth::guard($guard)->guest()) {
            if ($request->ajax() || $request->wantsJson() || $guard == “api”) {
                return response(‘Unauthorized.’, 401);
            } else {
                return redirect()->guest(‘login’);

            }
        }

        return $next($request);
    }
}

<?php

namespace App\Http\Middleware;

use Closure;

use Illuminate\Support\Facades\Auth;

class Authenticate

{

/**

* Handle an incoming request.

* @param \Illuminate\Http\Request $request

* @param \Closure $next

* @param string|null $guard

* @return mixed

public function handle($request, Closure $next, $guard = null)

{

if (Auth::guard($guard)->guest()) {

if ($request->ajax() || $request->wantsJson() || $guard == “api”) {

return response(‘Unauthorized.’, 401);

} else {

return redirect()->guest(‘login’);

}

return $next($request);

}

July 21, 2016

Android app dev: ShareActionProvider in Activity & Fragment

I’ve been taking the Developing Android Apps course on Udacity, and yesterday I encountered a difficulty in solving the Quiz: Share Intent.

One of the course’s goal is to build the Sunshine App – an Android app with weather forecast.

In that quiz I had to implement ShareActionProvider on my DetailsFragment so that a share icon becomes available on my app’s ActionBar.

One of the main difficulties was the error that stated ActionProvider cannot be cast into ShareActionProvider. And at some point there was also an error saying that the methods/classes I’m using require API 14, while my minimum supported API is 9. The Udacity course required that I set it to 9 so I couldn’t change that.

Now, the sharing in my app is working file, and I will share how I did it via Gist. I actually ended up taking a peek at the code provided by Developing Android Apps course on Udacity because I didn’t want to waste any more time doing trial-and-error (I have another project to work on! lol), but I still had to edit their code for ShareActionProvider here and there to make it bug-free.

And so, take a look at how my Sunshine app codes ended up:

July 21, 2016
Mac OS X – Sublime Text 2 key bindings suddenly stopped working (SOLVED)

https://www.sublimetext.com/docs/2/revert.html

I’m using a Mac Mini with OS X El Capitan (v. 10.11) with Sublime Text v.2.0.2.

Today, Sublime Text shortcuts like Cmd + / (line comment), Cmd + D (multiple selection), Cmd + F (find) and others stopped working. I had no problem with those key bindings before until today.

Based on research, I found that it could be caused by packages installed to Sublime Text. Aha! It could be the GoToClass package that I just installed today! I uninstalled it since I was desperate and the package didn’t work as I need it to anyway. Still no luck, my favorite Sublime Text shortcuts still didn’t work.

I decided to revert my Sublime Text into a clean install. That fixed my key bindings that stopped working.

I’ll show you how.

First, quit Sublime Text 2.

Then remove the “Sublime Text 2” folder that’s located at ~/Library/Application Support/. You may try to do so by running this command in the terminal:

rm -rf ~/Library/Application\ Support/Sublime\ Text\ 2/

1

rm –rf ~/Library/Application\ Support/Sublime\ Text\ 2/

FYI: The backslashes are required to escape the white spaces in file/folder names. rm is the command for removing files/folders. The -rf flag means that we want to remove the folder we specified and all its contents recursively.

Once deleted, run Sublime Text 2 again. You’ll notice that it’s back to its freshly installed state. 🙂

July 20, 2016

Laravel 5 RESTful API with Basic Auth: PHPUnit Testing

I’ve been using PHPUnit to test my RESTful API. PHPUnit is ready to use in Laravel.

In my Laravel-based RESTful API, I have an endpoint /api/users which returns JSON data when you send a GET request. The API will only return such data if the client sends the corrent username and password (Basic Authentication). The JSON data looks like this:

{“success”:true,”users”:[{“id”:1,”name”:”default”,”email”:”def@def.def”,”created_at”:”2016-07-08 20:23:47″,”updated_at”:”2016-07-08 20:23:47″},{“id”:2,”name”:”Eddard Stark”,”email”:”winter@westeros.org”,”created_at”:”2016-07-08 20:23:47″,”updated_at”:”2016-07-08 20:23:47″},{“id”:3,”name”:”Jon Snow”,”email”:”lorcommander@nightswatch.org”,”created_at”:”2016-07-08 20:23:47″,”updated_at”:”2016-07-08 20:23:47″},{“id”:4,”name”:”Sansa Stark”,”email”:”wholetthedogsout@winterfell.com”,”created_at”:”2016-07-08 20:23:48″,”updated_at”:”2016-07-08 20:23:48″},{“id”:5,”name”:”Tyrion Lanniter”,”email”:”ilikedragons@westeros.org”,”created_at”:”2016-07-08 20:23:48″,”updated_at”:”2016-07-08 20:23:48″},{“id”:6,”name”:”Lyanna Mormont”,”email”:”lyanna@bearisland.org”,”created_at”:”2016-07-08 20:23:48″,”updated_at”:”2016-07-08 20:23:48″},{“id”:7,”name”:”Davos Seaworth”,”email”:”seaworth@westeros.org”,”created_at”:”2016-07-08 20:23:48″,”updated_at”:”2016-07-08 20:23:48″},{“id”:8,”name”:”Daenerys Targaryen”,”email”:”queen@westeros.org”,”created_at”:”2016-07-08 20:23:48″,”updated_at”:”2016-07-08 20:23:48″},{“id”:9,”name”:”Cersei Lannister”,”email”:”longmayshereign@westeros.org”,”created_at”:”2016-07-08 20:23:48″,”updated_at”:”2016-07-08 20:23:48″},{“id”:10,”name”:”Gregor Clegane”,”email”:”hound@westeros.org”,”created_at”:”2016-07-08 20:23:48″,”updated_at”:”2016-07-08 20:23:48″}],”status_code”:200}

{“success”:true,“users”:[{“id”:1,“name”:“default”,“email”:“[email protected]”,“created_at”:“2016-07-08 20:23:47”,“updated_at”:“2016-07-08 20:23:47”},{“id”:2,“name”:“Eddard Stark”,“email”:“[email protected]”,“created_at”:“2016-07-08 20:23:47”,“updated_at”:“2016-07-08 20:23:47”},{“id”:3,“name”:“Jon Snow”,“email”:“[email protected]”,“created_at”:“2016-07-08 20:23:47”,“updated_at”:“2016-07-08 20:23:47”},{“id”:4,“name”:“Sansa Stark”,“email”:“[email protected]”,“created_at”:“2016-07-08 20:23:48”,“updated_at”:“2016-07-08 20:23:48”},{“id”:5,“name”:“Tyrion Lanniter”,“email”:“[email protected]”,“created_at”:“2016-07-08 20:23:48”,“updated_at”:“2016-07-08 20:23:48”},{“id”:6,“name”:“Lyanna Mormont”,“email”:“[email protected]”,“created_at”:“2016-07-08 20:23:48”,“updated_at”:“2016-07-08 20:23:48”},{“id”:7,“name”:“Davos Seaworth”,“email”:“[email protected]”,“created_at”:“2016-07-08 20:23:48”,“updated_at”:“2016-07-08 20:23:48”},{“id”:8,“name”:“Daenerys Targaryen”,“email”:“[email protected]”,“created_at”:“2016-07-08 20:23:48”,“updated_at”:“2016-07-08 20:23:48”},{“id”:9,“name”:“Cersei Lannister”,“email”:“[email protected]”,“created_at”:“2016-07-08 20:23:48”,“updated_at”:“2016-07-08 20:23:48”},{“id”:10,“name”:“Gregor Clegane”,“email”:“[email protected]”,“created_at”:“2016-07-08 20:23:48”,“updated_at”:“2016-07-08 20:23:48”}],“status_code”:200}

I’m gonna show you how to create a PHPUnit test for this kind of JSON API data in Laravel 5.

To create a test case, use this command:

 php artisan make:test ApiUsersTest

1	php artisan make:test ApiUsersTest

This will create a new test case named ApiUsersTest.php in your directory /tests

Paste the following code in it.

<?php

use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Foundation\Testing\DatabaseMigrations;
use Illuminate\Foundation\Testing\DatabaseTransactions;

class ApiUsersTest extends TestCase
{
    use DatabaseTransactions; 

    public function testGetAllUsersNoAuth()
    {
		$content = $this->call(‘GET’, ‘/api/users’)->getContent();
		$this->assertEquals($content, “Invalid credentials.”);
    }

    public function testGetAllUsersWithBasicAuth()
    {
	    $content = $this->call(‘GET’, ‘/api/users’,[],[], [], [
            “HTTP_Authorization” => “Basic ” . base64_encode(“username” . “:” . “password”),
            “PHP_AUTH_USER” => “username”, // must add this header since PHP won’t set it correctly
            “PHP_AUTH_PW” => “password” // must add this header since PHP won’t set it correctly as well
        ])->getContent();

		$json_content = json_decode($content);

        if(!empty($json_content->success)){
        	$this->assertTrue($json_content->success); // this test expects the JSON key “success” to have value of Boolean true
        }
        
	}

}

<?php

use Illuminate\Foundation\Testing\WithoutMiddleware;

use Illuminate\Foundation\Testing\DatabaseMigrations;

use Illuminate\Foundation\Testing\DatabaseTransactions;

class ApiUsersTest extends TestCase

{

use DatabaseTransactions;

public function testGetAllUsersNoAuth()

{

$content = $this->call(‘GET’, ‘/api/users’)->getContent();

$this->assertEquals($content, “Invalid credentials.”);

}

public function testGetAllUsersWithBasicAuth()

{

$content = $this->call(‘GET’, ‘/api/users’,[],[], [], [

“HTTP_Authorization” => “Basic “ . base64_encode(“username” . “:” . “password”),

“PHP_AUTH_USER” => “username”, // must add this header since PHP won’t set it correctly

“PHP_AUTH_PW” => “password” // must add this header since PHP won’t set it correctly as well

])->getContent();

$json_content = json_decode($content);

if(!empty($json_content->success)){

$this->assertTrue($json_content->success); // this test expects the JSON key “success” to have value of Boolean true

}

Edit the test case as needed.

July 9, 2016

Android M runtime permissions utility class

Hello world, I prepared a PermissionsUtil.java class and it’s on GitHub.

Check it out: AndroidPermissionsUtil

Why use it? It will help by letting you write less code as you add conditions to your Android app that supports Android 6.0 (Marshmallow). The utility class defines helper methods that were used in the following example.

Sample usage of Android M PermissionUtils

On the activity where you need to check for runtime permissions, add these:

private final int REQ_CODE_PERMS_FEATURE01 = 1;
String[] NEEDED_PERMS_FEATURE01 = { Manifest.permission.CAMERA, Manifest.permission.WRITE_EXTERNAL_STORAGE };

final PermissionsUtil permUtil = new PermissionsUtil(MainActivity.this);
permUtil.setNeededPermissions(NEEDED_PERMS_FEATURE01);
permUtil.setPermissionsRequestCode(REQ_CODE_PERMS_FEATURE01);

if(permUtil.allRequiredPermissionsGranted()){
    // proceed with what requires permission(s)
} else {
    permUtil.requestNeededPermissions();
}

private final int REQ_CODE_PERMS_FEATURE01 = 1;

String[] NEEDED_PERMS_FEATURE01 = { Manifest.permission.CAMERA, Manifest.permission.WRITE_EXTERNAL_STORAGE };

final PermissionsUtil permUtil = new PermissionsUtil(MainActivity.this);

permUtil.setNeededPermissions(NEEDED_PERMS_FEATURE01);

permUtil.setPermissionsRequestCode(REQ_CODE_PERMS_FEATURE01);

if(permUtil.allRequiredPermissionsGranted()){

// proceed with what requires permission(s)

} else {

permUtil.requestNeededPermissions();

}

And add the callback function to the same activity:

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        if (requestCode == REQ_CODE_PERMS_FEATURE01) {
            Boolean permissionRequestResult = permUtil.processPermissionsRequestResult(requestCode, permissions, grantResults);
            if(permissionRequestResult){
                // proceed to do what needed permission(s)
            } else {
                // oops, user denied permission request
            }
        } else {
            super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        }
    }

@Override

public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {

if (requestCode == REQ_CODE_PERMS_FEATURE01) {

Boolean permissionRequestResult = permUtil.processPermissionsRequestResult(requestCode, permissions, grantResults);

if(permissionRequestResult){

// proceed to do what needed permission(s)

} else {

// oops, user denied permission request

}

} else {

super.onRequestPermissionsResult(requestCode, permissions, grantResults);

}

Feel free to use in on any project. And please let me know if you have suggestions on how to improve that Android M runtime permissions utility class.

June 27, 2016

Android app codes for Google Maps with clustering

I prepared Android app codes with Google Maps and clustering feature. Feel free to use these as basis for your new projects.

They are on GitHub:

[1] Default Map Markers:
catzie/SimpleAndroidMapClustering

[2] Custom Map Markers:
catzie/Simple-Android-Map-Clustering-with-Custom-Markers

I simply took the necessary classes and res files from Android Maps Utility demo, and then placed them into bare Android Studio projects for simplicity. For me, it’s easier to start a new “maps with clustering” project on simple apps like these, rather than downloading the entire Android Maps Utility Demo, picking out the necessary files, and fixing errors before getting started each time. 😆

June 17, 2016

Android Maps: Get current location coordinates with Google API Client Builder

To get your current location via Google Map in an Android app, this was how we do it:

@Override
public void onMapReady(GoogleMap googleMap) {
    Location location = googleMap.getMyLocation();
}

@Override

public void onMapReady(GoogleMap googleMap) {

Location location = googleMap.getMyLocation();

}

Stop. Don’t use that! The method GoogleMap.getMyLocation() is deprecated. Instead, we need to use FusedLocationApi and the callback onLocationChanged().

Here’s an example code that works for me ( consider copying the contents of onResume() into onStart() ):

public class MainActivity extends FragmentActivity
        implements OnMapReadyCallback,
        GoogleApiClient.ConnectionCallbacks, GoogleApiClient.OnConnectionFailedListener,
        LocationListener {

    private GoogleMap map;
    private LocationRequest mLocationRequest;
    private GoogleApiClient mGoogleApiClient;
    private Location mLastLocation;
    private Marker marker;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

    }

    @Override
    protected void onResume() {
        super.onResume();

        if (mGoogleApiClient == null || !mGoogleApiClient.isConnected()){

            buildGoogleApiClient();
            mGoogleApiClient.connect();

        }

        if (map == null) {
            MapFragment mapFragment = (MapFragment) getFragmentManager()
                    .findFragmentById(R.id.map);

            mapFragment.getMapAsync(this);
        }
    }

    @Override
    public void onMapReady(GoogleMap retMap) {

        map = retMap;

        setUpMap();

    }

    public void setUpMap(){

        map.setMapType(GoogleMap.MAP_TYPE_HYBRID);
        map.setMyLocationEnabled(true);
    }

    @Override
    protected void onPause(){
        super.onPause();
        if (mGoogleApiClient != null) {
            LocationServices.FusedLocationApi.removeLocationUpdates(mGoogleApiClient, this);
        }
    }

    protected synchronized void buildGoogleApiClient() {
        Toast.makeText(this, “buildGoogleApiClient”, Toast.LENGTH_SHORT).show();
        mGoogleApiClient = new GoogleApiClient.Builder(this)
                .addConnectionCallbacks(this)
                .addOnConnectionFailedListener(this)
                .addApi(LocationServices.API)
                .build();
    }

    @Override
    public void onConnected(Bundle bundle) {
        Toast.makeText(this,”onConnected”, Toast.LENGTH_SHORT).show();

        mLocationRequest = new LocationRequest();
        mLocationRequest.setInterval(1000);
        mLocationRequest.setFastestInterval(1000);
        mLocationRequest.setPriority(LocationRequest.PRIORITY_BALANCED_POWER_ACCURACY);

        //mLocationRequest.setSmallestDisplacement(0.1F);

        LocationServices.FusedLocationApi.requestLocationUpdates(mGoogleApiClient, mLocationRequest, this);
    }

    @Override
    public void onConnectionSuspended(int i) {

    }

    @Override
    public void onConnectionFailed(ConnectionResult connectionResult) {

    }

    @Override
    public void onLocationChanged(Location location) {
        mLastLocation = location;

        //remove previous current location Marker
        if (marker != null){
            marker.remove();
        }

        double dLatitude = mLastLocation.getLatitude();
        double dLongitude = mLastLocation.getLongitude();
        marker = map.addMarker(new MarkerOptions().position(new LatLng(dLatitude, dLongitude))
                .title(“My Location”).icon(BitmapDescriptorFactory
                        .defaultMarker(BitmapDescriptorFactory.HUE_RED)));
        map.moveCamera(CameraUpdateFactory.newLatLngZoom(new LatLng(dLatitude, dLongitude), 8));

    }

}

100

101

102

103

104

105

106

107

108

109

110

111

112

public class MainActivity extends FragmentActivity

implements OnMapReadyCallback,

GoogleApiClient.ConnectionCallbacks, GoogleApiClient.OnConnectionFailedListener,

LocationListener {

private GoogleMap map;

private LocationRequest mLocationRequest;

private GoogleApiClient mGoogleApiClient;

private Location mLastLocation;

private Marker marker;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

}

@Override

protected void onResume() {

super.onResume();

if (mGoogleApiClient == null || !mGoogleApiClient.isConnected()){

buildGoogleApiClient();

mGoogleApiClient.connect();

}

if (map == null) {

MapFragment mapFragment = (MapFragment) getFragmentManager()

.findFragmentById(R.id.map);

mapFragment.getMapAsync(this);

}

@Override

public void onMapReady(GoogleMap retMap) {

map = retMap;

setUpMap();

}

public void setUpMap(){

map.setMapType(GoogleMap.MAP_TYPE_HYBRID);

map.setMyLocationEnabled(true);

}

@Override

protected void onPause(){

super.onPause();

if (mGoogleApiClient != null) {

LocationServices.FusedLocationApi.removeLocationUpdates(mGoogleApiClient, this);

}

protected synchronized void buildGoogleApiClient() {

Toast.makeText(this, “buildGoogleApiClient”, Toast.LENGTH_SHORT).show();

mGoogleApiClient = new GoogleApiClient.Builder(this)

.addConnectionCallbacks(this)

.addOnConnectionFailedListener(this)

.addApi(LocationServices.API)

.build();

}

@Override

public void onConnected(Bundle bundle) {

Toast.makeText(this,“onConnected”, Toast.LENGTH_SHORT).show();

mLocationRequest = new LocationRequest();

mLocationRequest.setInterval(1000);

mLocationRequest.setFastestInterval(1000);

mLocationRequest.setPriority(LocationRequest.PRIORITY_BALANCED_POWER_ACCURACY);

//mLocationRequest.setSmallestDisplacement(0.1F);

LocationServices.FusedLocationApi.requestLocationUpdates(mGoogleApiClient, mLocationRequest, this);

}

@Override

public void onConnectionSuspended(int i) {

}

@Override

public void onConnectionFailed(ConnectionResult connectionResult) {

}

@Override

public void onLocationChanged(Location location) {

mLastLocation = location;

//remove previous current location Marker

if (marker != null){

marker.remove();

}

double dLatitude = mLastLocation.getLatitude();

double dLongitude = mLastLocation.getLongitude();

marker = map.addMarker(new MarkerOptions().position(new LatLng(dLatitude, dLongitude))

.title(“My Location”).icon(BitmapDescriptorFactory

.defaultMarker(BitmapDescriptorFactory.HUE_RED)));

map.moveCamera(CameraUpdateFactory.newLatLngZoom(new LatLng(dLatitude, dLongitude), 8));

}

Code source: How to get current location of device on google maps api v2, getMyLocation() method is deprecated

June 10, 2016

Bash: rename all files in directory, replacing all hyphens (-) with underscores (_)

I don’t want to waste time doing things manually when I can run a script that will help me save time and effort.

When using Linux or Mac command line (bash?), if you want to rename all files in your present directory and replace all hyphens - with underscores _, run this command:

for f in *-*; do mv “$f” “${f//-/_}”; done

1

for f in *–*; do mv “$f” “${f//-/_}”; done

And if you want to do the reverse, i.e., replace all underscores _ with hyphens -, run this command instead:

for f in *_*; do mv “$f” “${f//_/-}”; done

1

for f in *_*; do mv “$f” “${f//_/-}”; done

To remove substring from file names, (e.g., remove @3x string), run this:

for f in *@3x*; do mv “$f” “${f//@3x/}”; done

1

for f in *@3x*; do mv “$f” “${f//@3x/}”; done

I had to do this after importing image files with hyphens in their names into my Android project. I can’t use images with hyphens in their names.

June 9, 2016

Android Studio: add Google Map from empty activity (dev note)

//Update: I prepared a simple Android app that features a Google Map with markers that form clusters together when zoomed out. Check it out: Simple Android Map Clustering on GitHub.

This “dev note” of mine will give you a rough idea on how to add a Google Map to your Android up from an empty activity, not from a pre-made Google Maps activity.

I won’t be able to write everything in detail here because I’m in a hurry, and so I’m calling this article a “dev note” instead of tutorial. 🙂 This dev note can be considered a “guide” too.

This dev note was based on Android Studio v.2.1 running on MAC OS X

From your Android Studio’s SDK Manager, install Google Play Services.

Add this as child of <application> tag in AndroidManifest.xml:

    <meta-data
        android:name=”com.google.android.geo.API_KEY”
        android:value=”YOUR_API_KEY”/>

<meta–data

android:name=“com.google.android.geo.API_KEY”

android:value=“YOUR_API_KEY”/>

Later we’ll replace YOUR_API_KEY with a key from Google API Console.

Also add these to your AndroidManifest.xml as direct child of manifest tag:

<permission android:name=”com.yourdomain.projname.permission.MAPS_RECEIVE”
        android:protectionLevel=”signature” />
<uses-permission android:name=”android.permission.ACCESS_FINE_LOCATION” />

<permission android:name=“com.yourdomain.projname.permission.MAPS_RECEIVE”

android:protectionLevel=“signature” />

<uses–permission android:name=“android.permission.ACCESS_FINE_LOCATION” />

We need to get an API KEY for the value attribute of this meta data. Let’s get one from the Google API Console — create a new project there and then search for Google Maps Android API. Enable it.

After enabling it, you’ll find a way to get an API key that we need from Google API Console. Go to Credentials -> Create Credentials -> API Key -> Android Key. Before we are given the API key, we need to provide Google API Console a SHA1 certificate fingerprint from our computer and our app’s package name.

To generate SHA1 certificate fingerprint on a Mac, type this on the terminal:

keytool -exportcert -alias androiddebugkey -keystore ~/.android/debug.keystore -list -v

1	keytool –exportcert –alias androiddebugkey –keystore ~/.android/debug.keystore –list –v

On Windows, try this command:

keytool -list -v -keystore “%USERPROFILE%\.android\debug.keystore” -alias androiddebugkey -storepass android -keypass android

1	keytool –list –v –keystore “%USERPROFILE%\.android\debug.keystore” –alias androiddebugkey –storepass android –keypass android

When prompted for a keystore password, enter the word debug as your password.

Copy the SHA1 certificate fingerprint and then paste it into Google API Console. Enter your package name as well (e.g. com.yourdomain.projname). You’ll be given an API Key in return.

Note: My Android Studio says ‘In the Google Developer Console (https://console.developers.google.com), ensure that the “Google Maps Android API v2” is enabled.’ but I can’t find the option for V2.

Remember the meta-data tag we added in the AndroidManifest.xml? Replace the value with the API key that you just copied from Google API Console.

Resource: https://developers.google.com/maps/documentation/android-api/signup

Open app/build.gradle file and add the following as dependency:

compile ‘com.google.android.gms:play-services-maps:8.4.0’

1	compile ‘com.google.android.gms:play-services-maps:8.4.0’

Sync your project with Gradle files.

This was one of the tutorials I followed: GOOGLE MAPS ANDROID API V2 TUTORIAL USING ANDROID STUDIO and I based my XML plus Java codes on the author’s.

My files in the end…

Here were the codes of my Android app when I finally made the Google Map show up in the activity:

app/build.gradle

apply plugin: ‘com.android.application’

android {
    compileSdkVersion 23
    buildToolsVersion “23.0.3”
    defaultConfig {
        applicationId “net.catzie.maptest”
        minSdkVersion 16
        targetSdkVersion 23
        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.3.0’
    compile ‘com.google.android.gms:play-services-maps:8.4.0’
}

apply plugin: ‘com.android.application’

android {

compileSdkVersion 23

buildToolsVersion “23.0.3”

defaultConfig {

applicationId “net.catzie.maptest”

minSdkVersion 16

targetSdkVersion 23

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.3.0’

compile ‘com.google.android.gms:play-services-maps:8.4.0’

}

build.gradle

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath ‘com.android.tools.build:gradle:2.1.0’

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories{
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {

repositories {

jcenter()

}

dependencies {

classpath ‘com.android.tools.build:gradle:2.1.0’

// NOTE: Do not place your application dependencies here; they belong

// in the individual module build.gradle files

}

allprojects {

repositories{

jcenter()

}

task clean(type: Delete) {

delete rootProject.buildDir

}

app/src/main/res/layout/activity_main.xml

<?xml version=”1.0″ encoding=”utf-8″?>

<RelativeLayout xmlns:android=”http://schemas.android.com/apk/res/android”
xmlns:tools=”http://schemas.android.com/tools” android:layout_width=”match_parent”
android:layout_height=”match_parent” android:paddingLeft=”@dimen/activity_horizontal_margin”
android:paddingRight=”@dimen/activity_horizontal_margin”
android:paddingTop=”@dimen/activity_vertical_margin”
android:paddingBottom=”@dimen/activity_vertical_margin” tools:context=”.MainActivity”>

    <fragment xmlns:android=”http://schemas.android.com/apk/res/android”
        xmlns:map=”http://schemas.android.com/apk/res-auto”
        xmlns:tools=”http://schemas.android.com/tools”
        android:id=”@+id/map”
        android:name=”com.google.android.gms.maps.SupportMapFragment”
        android:layout_width=”match_parent”
        android:layout_height=”match_parent”
        tools:context=”net.catzie.maptestpremade.MapsActivity”
        class=”com.google.android.gms.maps.MapFragment” />

</RelativeLayout>

<?xml version=“1.0” encoding=“utf-8”?>

<RelativeLayout xmlns:android=“http://schemas.android.com/apk/res/android”

xmlns:tools=“http://schemas.android.com/tools” android:layout_width=“match_parent”

android:layout_height=“match_parent” android:paddingLeft=“@dimen/activity_horizontal_margin”

android:paddingRight=“@dimen/activity_horizontal_margin”

android:paddingTop=“@dimen/activity_vertical_margin”

android:paddingBottom=“@dimen/activity_vertical_margin” tools:context=“.MainActivity”>

<fragment xmlns:android=“http://schemas.android.com/apk/res/android”

xmlns:map=“http://schemas.android.com/apk/res-auto”

xmlns:tools=“http://schemas.android.com/tools”

android:id=“@+id/map”

android:name=“com.google.android.gms.maps.SupportMapFragment”

android:layout_width=“match_parent”

android:layout_height=“match_parent”

tools:context=“net.catzie.maptestpremade.MapsActivity”

class=“com.google.android.gms.maps.MapFragment” />

</RelativeLayout>

app/src/main/java/net/catzie/maptest/MainActivity.java

package net.catzie.maptest;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import com.google.android.gms.maps.CameraUpdateFactory;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.MapFragment;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.Marker;
import com.google.android.gms.maps.model.MarkerOptions;

public class MainActivity extends AppCompatActivity {

    private static final LatLng GREENBELT1 = new LatLng(14.553048, 121.020030);
    private GoogleMap map;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        map = ((MapFragment) getFragmentManager().findFragmentById(R.id.map)).getMap();

        Marker davao = map.addMarker(new MarkerOptions().position(GREENBELT1).title(“Greenbelt 1”).snippet(“San Lorenzo, Makati”));

        // zoom in the camera to Greenbelt 1
        map.moveCamera(CameraUpdateFactory.newLatLngZoom(GREENBELT1, 15));

        // animate the zoom process
        map.animateCamera(CameraUpdateFactory.zoomTo(15), 2000, null);
    }


}

package net.catzie.maptest;

import android.os.Bundle;

import android.support.v7.app.AppCompatActivity;

import com.google.android.gms.maps.CameraUpdateFactory;

import com.google.android.gms.maps.GoogleMap;

import com.google.android.gms.maps.MapFragment;

import com.google.android.gms.maps.model.LatLng;

import com.google.android.gms.maps.model.Marker;

import com.google.android.gms.maps.model.MarkerOptions;

public class MainActivity extends AppCompatActivity {

private static final LatLng GREENBELT1 = new LatLng(14.553048, 121.020030);

private GoogleMap map;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

map = ((MapFragment) getFragmentManager().findFragmentById(R.id.map)).getMap();

Marker davao = map.addMarker(new MarkerOptions().position(GREENBELT1).title(“Greenbelt 1”).snippet(“San Lorenzo, Makati”));

// zoom in the camera to Greenbelt 1

map.moveCamera(CameraUpdateFactory.newLatLngZoom(GREENBELT1, 15));

// animate the zoom process

map.animateCamera(CameraUpdateFactory.zoomTo(15), 2000, null);

}

app/src/main/AndroidManifest.xml

<?xml version=”1.0″ encoding=”utf-8″?>
<manifest xmlns:android=”http://schemas.android.com/apk/res/android”
    package=”net.catzie.maptest” >

    <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>



        <meta-data
            android:name=”com.google.android.geo.API_KEY”
            android:value=”YOUR_OWN_API_KEY”/>
    </application>

    <permission android:name=”net.catzie.maptest.permission.MAPS_RECEIVE”
        android:protectionLevel=”signature” />




</manifest>

<?xml version=“1.0” encoding=“utf-8”?>

<manifest xmlns:android=“http://schemas.android.com/apk/res/android”

package=“net.catzie.maptest” >

<application

android:allowBackup=“true”

android:icon=“@mipmap/ic_launcher”

android:label=“@string/app_name”

android:supportsRtl=“true”

android:theme=“@style/AppTheme” >

<intent–filter>

</intent–filter>

</activity>

<meta–data

android:name=“com.google.android.geo.API_KEY”

android:value=“YOUR_OWN_API_KEY”/>

</application>

<permission android:name=“net.catzie.maptest.permission.MAPS_RECEIVE”

android:protectionLevel=“signature” />

</manifest>

…even though the Google Map now shows up on my Android activity, I get these errors that I’m not able to fix yet:

05-27 12:12:39.251 20805-20805/net.catzie.maptest E/MPlugin: Unsupported class: com.mediatek.common.telephony.IOnlyOwnerSimSupport
05-27 12:12:40.073 20805-21000/net.catzie.maptest E/[DRVB][EXT][UTIL]: disp_only_chk: DRVB CHECK DISP PROCESS DONE ! (2/0x47/0x48/0x46)
05-27 12:12:40.074 20805-21000/net.catzie.maptest E/[DRVB][EXT][UTIL]: disp_only_chk: DRVB CHECK DISP PROCESS DONE ! (720/1280/1)
05-27 12:12:40.122 20805-20960/net.catzie.maptest E/NativeCrypto: ssl=0xb8465640 cert_verify_callback x509_store_ctx=0x9f5774c8 arg=0x0
05-27 12:12:40.122 20805-20960/net.catzie.maptest E/NativeCrypto: ssl=0xb8465640 cert_verify_callback calling verifyCertificateChain authMethod=ECDHE_ECDSA
05-27 12:12:40.422 20805-21000/net.catzie.maptest E/libEGL: cache file failed CRC check
05-27 12:12:41.791 20805-20991/net.catzie.maptest E/DynamiteModule: Failed to load module descriptor class: Didn’t find class “com.google.android.gms.dynamite.descriptors.com.google.android.gms.googlecertificates.ModuleDescriptor” on path: DexPathList[[zip file “/data/app/net.catzie.maptest-2/base.apk”],nativeLibraryDirectories=[/vendor/lib, /system/lib]]
05-27 12:12:42.355 20805-20959/net.catzie.maptest E/NativeCrypto: ssl=0xb86ce8b8 cert_verify_callback x509_store_ctx=0x9f6804f8 arg=0x0
05-27 12:12:42.355 20805-20959/net.catzie.maptest E/NativeCrypto: ssl=0xb86ce8b8 cert_verify_callback calling verifyCertificateChain authMethod=ECDHE_ECDSA

05–27 12:12:39.251 20805–20805/net.catzie.maptest E/MPlugin: Unsupported class: com.mediatek.common.telephony.IOnlyOwnerSimSupport

05–27 12:12:40.073 20805–21000/net.catzie.maptest E/[DRVB][EXT][UTIL]: disp_only_chk: DRVB CHECK DISP PROCESS DONE ! (2/0x47/0x48/0x46)

05–27 12:12:40.074 20805–21000/net.catzie.maptest E/[DRVB][EXT][UTIL]: disp_only_chk: DRVB CHECK DISP PROCESS DONE ! (720/1280/1)

05–27 12:12:40.122 20805–20960/net.catzie.maptest E/NativeCrypto: ssl=0xb8465640 cert_verify_callback x509_store_ctx=0x9f5774c8 arg=0x0

05–27 12:12:40.122 20805–20960/net.catzie.maptest E/NativeCrypto: ssl=0xb8465640 cert_verify_callback calling verifyCertificateChain authMethod=ECDHE_ECDSA

05–27 12:12:40.422 20805–21000/net.catzie.maptest E/libEGL: cache file failed CRC check

05–27 12:12:41.791 20805–20991/net.catzie.maptest E/DynamiteModule: Failed to load module descriptor class: Didn‘t find class “com.google.android.gms.dynamite.descriptors.com.google.android.gms.googlecertificates.ModuleDescriptor” on path: DexPathList[[zip file “/data/app/net.catzie.maptest-2/base.apk”],nativeLibraryDirectories=[/vendor/lib, /system/lib]]

05–27 12:12:42.355 20805–20959/net.catzie.maptest E/NativeCrypto: ssl=0xb86ce8b8 cert_verify_callback x509_store_ctx=0x9f6804f8 arg=0x0

05–27 12:12:42.355 20805–20959/net.catzie.maptest E/NativeCrypto: ssl=0xb86ce8b8 cert_verify_callback calling verifyCertificateChain authMethod=ECDHE_ECDSA

May 27, 2016