SharinPix WebView on a Native Android Mobile Application
A WebView is a component inside a Java Android application which allows the display of a web app inside a mobile application. By running the SharinPix web app inside a WebView, your native Java Android application will contain the SharinPix experience usually available on Salesforce and the web. It can be seen as the equivalent of an iframe tag in HTML.
- The folks at AppCoda have a simple tutorial on how to include a basic WebView in your application. You can follow it and try embedding SharinPix in your own app.
- You have to use the link https://app.sharinpix.com/?token=XXXXX in your created WebView with a generated token.
Below is an example of a apex code:
token = sharinpix.Client.getInstance().token(
new Map<String, Object> {
'Id' => wOrder.Id, //example of an albumId
'exp' => 0,
'path' => '/pagelayout/' + wOrder.Id,
'abilities' => new Map<String, Object> {
wOrder.Id => new Map<String, Object> {
'Access' => new Map<String, Boolean> {
'see' => true,
'image_list' => true,
'image_upload' => true,
'image_delete' => true
}
},
'Display' => new Map<String, Object> {
'tags'=> true
}
}
}
);Example of a SharinPixWebView with the link
The code below demonstrates how to create a SharinPixWebView using the onCreate method in the activity.
It sets a listener setOnResultListener to check all the returning results from the SharinPixWebView controller. Based on this example when a result is returned, a popup/toast is shown.
In the onActivityResult method, it sends the activity results to the SharinPixWebView controller.
public class MainActivity extends AppCompatActivity {
private ActivityMainBinding binding;
private SharinPixWebView sharinPixWebView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
binding = ActivityMainBinding.inflate(getLayoutInflater());
setContentView(binding.getRoot());
this.sharinPixWebView = new SharinPixWebView(MainActivity.this, R.id.webView, "https://app.sharinpix.com/?token=XXXXX");
this.sharinPixWebView.setOnResultListener(new SharinPixWebView.OnResultListener() {
@Override
public void onResult(JSONObject jsonObject) throws JSONException {
Toast.makeText(getApplicationContext(), jsonObject.getString("name"), Toast.LENGTH_LONG).show();
}
});
}
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
this.sharinPixWebView.onActivityResult(requestCode, resultCode, data);
}
}Steps for Installing SharinPixWebView Library
In settings.gradle include this line:
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
.
.
.
mavenCentral()
}
}In build.gradle for your project module include this line:
dependencies {
implementation 'io.github.SharinPix:sharinpixwebview-android:LATEST_VERSION'
}Check for latest release on GitHub or Maven Central Repository Search: https://github.com/SharinPix/sharinpixwebview-android or https://search.maven.org/artifact/io.github.SharinPix/sharinpixwebview-android
Example for Overriding the onActivityFunction Function
Make sure to override the onActivityResult function in your activity and pass the parameters to the custom function on SharinPixWebView.
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
this.sharinPixWebView.onActivityResult(requestCode, resultCode, data);
}Example for Creating an Instance of SharinPixWebView
When creating a new instance of SharinPixWebView, you should pass the following parameter:
- Activity: the main activity from which your WebView
- WebView ID
- URL
this.sharinpixWebView = new SharinPixWebView(MainActivity.this, R.id.webView, "https://app.sharinpix.com/?token=XXXXX");Example for Implementing the SharinPixWebView Listener
To be able to receive post messages from the SharinPix application, make sure to implement the custom listener.
this.sharinpixWebView.setOnResultListener(new SharinPixWebView.OnResultListener() {
@Override
public void onResult(JSONObject jsonObject) throws JSONException {
Toast.makeText(getApplicationContext(), jsonObject.getString("name"), Toast.LENGTH_LONG).show();
}
});The screenshot below shows images that are uploaded on the SharinPix application.
The screenshot shows a native toast being shown on the mobile application with the event that has been triggered when deleting an image on the SharinPix application.
0 Comments
Add your comment