> For the complete documentation index, see [llms.txt](https://docs.sharinpix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sharinpix.com/documentation/integrations/other-apps/sharinpix-webview-on-a-native-android-mobile-application.md).

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

{% hint style="info" %}

* The folks at AppCoda have a [simple tutorial](https://www.javatpoint.com/android-webview-example) 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.
  {% endhint %}

Below is an example of a apex code:

```apex
    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.

```apex
    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:

```apex
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            .
            .
            .
            mavenCentral()
        }
    }
```

In build.gradle for your project module include this line:

```apex
    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.

```apex
    @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

```apex
    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.

```apex
    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.

<figure><img src="/files/VXdkhhrKBndD1YrEq6ur" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/EOFWHDd3M7MwUqB3klKG" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sharinpix.com/documentation/integrations/other-apps/sharinpix-webview-on-a-native-android-mobile-application.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.