User avatar
johan
GpsGate
Posts: 14733
Joined: Wed Aug 04, 2004 10:40 pm
Location: Sweden
Contact: Website

GUIDE: How to build your own web repository

Wed Mar 16, 2011 2:58 pm

How to build your own web repository

You never copy files into the installations folders. Instead you use the Plugin deployment feature.

As a normal administrator of a server you can download and install plugins from SiteAdmin -> Plugins. You also find a custom URL field there where you can enter the address to new repositories of plugins.

As a developer you want it to be easy to distribute your Plugins to all GpsGate Server installations out there. To do that you build your own web repository, and you ask the customer/user tyo enter your web repository URL under SiteAdmin -> Plugins. In this way the user/customer can download and install your plugin. This is also the mechanism for upgrades.

If you have a super cool Plugin you can also contact GpsGate and we will consider including the Plugin into our main update.gpsgate.com repository.

Follow those steps to create a repository:

1. Create a web site with "index.xml" as default page.

2. Take a look at this sample repository:
http://franson.com/gpsgateserver/Samples/SampleRepository.zip

It contains the following sample plugins:

CloudMade - How to install a Script Plugin (Javascript extension of user interface).
Detailed Distance Report - A Reporting 3.0 report.
Dispatch Application - An Application Template
PointOfInterest - Many types of resources combined.
Teltonika - Device Driver + Template Commands.
Thai Language - lang file.
WebTech - driver without commands

3. Build your own "DeployPackage" for your plugin and upload the files to your web server in the same file structure as described in the sample.

4. Test your web repository from your GpsGate Server installation under SiteAdmin -> Plugin.

Regards,
Johan

GpsGate Support

User avatar
johan
GpsGate
Posts: 14733
Joined: Wed Aug 04, 2004 10:40 pm
Location: Sweden
Contact: Website

RE: GUIDE: How to build your own web repository

Fri Apr 29, 2011 12:35 pm

To re-scan the ScriptPlugins during development use this Plugin:
http://forum.gpsgate.com/topic.asp?TOPIC_ID=12914

Regards,
Johan

GpsGate Support

User avatar
johan
GpsGate
Posts: 14733
Joined: Wed Aug 04, 2004 10:40 pm
Location: Sweden
Contact: Website

RE: GUIDE: How to build your own web repository

Tue Jul 16, 2013 2:12 pm

You can add a dependency for the Plugin, in this way the user cannot install the plugin without first installing plugins your Plugins is dependent on.

This is very useful to make sure the user has all per-requisit plugins installed and updated to required version.

Here is an example of the Maintenance plugin dependent on Reporting v3.1.0.4829 and Interval Event v3.1.0.4176

Code: Select all

  <DeployPackage>
    <Dependency>
      <Name>Reporting</Name>
      <Namespace>com.GpsGate</Namespace>
      <MinPackageVersion>3.1.0.4829</MinPackageVersion>
    </Dependency>
    <Dependency>
      <Name>Interval Event</Name>
      <Namespace>com.GpsGate</Namespace>
      <MinPackageVersion>3.1.0.4176</MinPackageVersion>
    </Dependency>    
    <RequiresValidSupport>1</RequiresValidSupport>
    <Name>Maintenance</Name>
    <Namespace>com.GpsGate</Namespace>
    <Category>Feature</Category>
    <Description>Maintenance</Description>
    <PackageVersion>3.1.0.4829</PackageVersion>
    <ServerVersion>3.0.0.2583</ServerVersion>
    <DownloadUrl>3.0.0.2583/com.GpsGate/Maintenance/3.1.0.4829/Maintenance.zip</DownloadUrl>
    <HomepageUrl>http://gpsgate.com/blogComment/track_vehicle_maintenance</HomepageUrl>
  </DeployPackage>
Regards,
Johan

GpsGate Support

User avatar
david
GpsGate
Posts: 11
Joined: Wed Mar 30, 2016 4:10 pm
Location: Sweden

Re: GUIDE: How to build your own web repository

Mon Nov 19, 2018 1:50 pm

CloudMade is deprecated. Replaced by Native Map instead: https://support.gpsgate.com/hc/en-us/articles/360005938334-Native-Map
It's very likely CloudMade is still included in the zip.
Please address support@gpsgate.com if you need this kit.
David

Return to “GpsGate for Developers”