aspera connect sdk js herunterladen – aspera connect sdk js Quellcode herunterladen

aspera connect sdk js

Anderer Quellcode

v5.0.3

Herunterladen

Offizielles Aspera Connect SDK für JavaScript

Ermöglicht Webanwendungen die Nutzung der Dateiübertragungsfunktionen von Aspera.

Die Dokumentation finden Sie auf den GitHub-Seiten.

Installation

Von npm installieren:

$ npm install --save @ibm-aspera/connect-sdk-js

Von der Quelle installieren:

$ git clone https://github.com/IBM/aspera-connect-sdk-js.git
$ cd aspera-connect-sdk-js
$ npm install

Vom CDN laden:

 < script src =" https://d3gcli72yxqn2z.cloudfront.net/@ibm-aspera/connect-sdk-js/latest/connect-sdk.js " > </ script >

Wenn Sie das Connect SDK über CDN einbetten, wird dringend empfohlen, eine bestimmte Version anstelle der neuesten Version zu verwenden. Das neueste Connect SDK kann jederzeit geändert werden, was sich möglicherweise auf Ihre Website auswirken könnte.

Verwendung

Starten Sie die Connect-Desktopanwendung und stellen Sie eine Verbindung mit ihr her:

 import { Connect } from '@ibm-aspera/connect-sdk-js' ;

const connectClient = new Connect ( ) ;
connectClient . initSession ( ) ;

Starten Sie einen Download:

 try {
  const transferSpec = {
    authentication : 'token' ,
    paths : [
      {
        source : 'my_awesome_movie.drp'
      }
    ] ,
    remote_host : 'example.com' ,
    remote_user : 'foo' ,
    token : 'ATV7_HtfhDa-JwWfc6RkTwhkDUqjHeLQePiOHjIS254_LJ14_7VTA' ,
    direction : 'receive'
  } ;

  const response = await connectClient . startTransferPromise ( transferSpec ) ;
  console . log ( `Transfer started: ${ response } ` ) ;
} catch ( err ) {
  throw new Error ( `Could not start transfer: ${ err } ` ) ;
}

Weitere Codebeispiele finden Sie in den bereitgestellten Beispielen.

Migration von 3.x/4.x auf 5.0.0

Informationen zu den erforderlichen Änderungen beim Aktualisieren Ihres Codes auf v5.0.0 finden Sie unter MIGRATION.

Entwicklung

Voraussetzungen

Node.js v12+
- Wenn Sie macOS verwenden, empfehlen wir die Installation von Node.js über einen Paketmanager wie nvm.
Git

Bauen

$ git clone https://github.com/IBM/aspera-connect-sdk-js.git
$ cd aspera-connect-sdk-js
$ npm install
$ npm run build

Lokales Hosten der Connect-Desktop-Installationsprogramme

Anstatt Benutzer Connect von Cloudfront herunterladen zu lassen, ist es möglich, die Installationsprogramme lokal zu hosten. Dies ist besonders nützlich, wenn Ihr Server in einer Offline-Umgebung läuft (dh Benutzer haben keinen Zugriff auf Cloudfront) oder wenn Sie einfach möchten, dass Benutzer Connect von Ihrem Server herunterladen.

So laden Sie das connect-deployer -Docker-Image herunter:

$ docker pull icr.io/ibmaspera/connect-deployer:latest

Ab Connect 4.2.2 sind auch Versions-Tags verfügbar (z. B. docker pull icr.io/ibmaspera/connect-deployer:4.2.2 ).

So hosten Sie die Installationsprogramme auf einem einfachen Webserver:

$ docker run -it --rm -d -p 8080:80 icr.io/ibmaspera/connect-deployer:latest

Mit dem obigen Befehl sind die Connect-Installationsprogramme über http://127.0.0.1:8080/aspera/connect verfügbar. Um das Connect SDK für die Bereitstellung der Connect-Installationsprogramme über diese URL zu konfigurieren, müssen Sie sdkLocation auf die oben genannte URL aktualisieren.

So hosten Sie die Installationsprogramme über einen sicheren Webserver:

$ docker run -it --rm -d -p 8443:443  -v /path/to/your/ssl/certs:/etc/ssl/certs icr.io/ibmaspera/connect-deployer:latest

Hinweis: Das Serverzertifikat und der private Schlüssel müssen cert.pem bzw. key.pem heißen.

Mitwirken

Wir sind immer auf der Suche nach Mitwirkenden, die uns bei der Behebung von Fehlern, der Entwicklung neuer Funktionen oder der Verbesserung der Projektdokumentation helfen. Wenn Sie interessiert sind, schauen Sie sich unbedingt unseren Contributing Guide an.