WebIntents - GitLite

KO | EN

gitlite — search

#react-native #dotnet #api #http #privacy #large-language-models #automation #sql #go #graphql

WebIntents

(★ 482)

A client side service discovery and execution model.

File Explorer

ZIP Download

- share.pxm
- share16.png
- share32.png
- README.md
- - jasmine-html.js
  - jasmine.css
  - jasmine.js
  - json2.js
- - workspace.xml
- - __init__.py
- - __init__.py
- - application.js
  - base64.js
  - common.js
  - events.js
  - json2.js
- - __init__.py
  - handlers.py
  - intentparser.py
  - README.md
  - runtests.sh
  - tests.py
- - application.css
  - base.css
  - embedbase.css
  - reset.css
- - __init__.py
  - cache.manifest.src
- - __init__.py
  - handlers.py
- app.yaml
- handlers_base.py
- index.yaml
- run.sh
- server.py
- base64.js
- debug.js
- json2.js
- release.js
- webintents-prefix.js
- webintents.js
- - key.pem
.gitignore
LICENSE
Makefile
NOTICE
packcrx.sh
README.md
SpecRunner.html
webintents.idl

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Web Intents
===========

Web Intents is a discovery mechanism and extremely light-weight RPC system between web apps, modeled after the similarly-named system in Android.  An Intent is an action to be performed by a provider.  Intents provides a declarative syntax that allows providers to list the Intents they handle and a registration system that enumerates available providers.  A client requests an Intent be handled, the User Agent allows the user to select which provider to use, and the provider performs the action of the Intent, possibly using data passed as input in the Intent.  The provider may return data as output to the client.

Usage
=====

To use today
------------
No browsers currently support this API natively.  To use this system simple drop the following code in to your site:

<script src="http://webintents.org/webintents.min.js"></script>

When browsers start to implement this natively the Shim will defer all its functionality to the native interface.

Declaration
-----------

To register your service application to be able to handle image sharing simply declare an intent tag.

<intent 
      action="http://webintents.org/share"
      type="image/*" />

This will register the current page's ability to share images.

Invocation
----------

To build a client application that can use the share functionality, it is as simple as using the following code:

var intent = new Intent(
        "http://webintents.org/share", 
        "image/*", 
        "http://upload.wikimedia.org/wikipedia/commons/thumb/f/f8/Three_jolly_kittens.png/800px-Three_jolly_kittens.png" 
    );
    window.navigator.startActivity(intent);

Service
-------

When a service is invoked via startActivity, the "intent" object on window will be populated with the data provided by the client.

window.intent

That's it.

To send data back to the client that invoked it, it is as simple as calling postResult() on the intent.

window.intent.postResult("something cool");

Building
========
Prerequisites:
Node.js: http://nodejs.org/
NPM: http://npmjs.org/
    uglify-js: npm -g install uglify-js
    
    ./make all

This will build and minify both the server and client components.

Building Tools
--------------

The tools are a collection of all the apps and extensions that are currently live and available on the web.

./make tools

Building Apps
-------------

The apps are a subset of tools, are fully formed, live web apps such as cloudfilepicker.com

./make apps

Building Extensions
-------------------

The extensions are a subset of tools and are fully formed extensions for browsers that support intents.

./make extensions

Running
=======

Prerequisites:
AppEngine: http://appengine.google.com/
nginx: http://nginx.org/en/

To run the server locally:

./server/run.sh

The server will not be set up on port 80 or webintents.org so will need to do the following:

1) Edit /etc/hosts - add the following "127.0.0.1 webintents.org"
2) Start nginx using using the configuration in https://github.com/PaulKinlan/WebIntents/tree/master/conf