DESCRIPTION
This is a Dos handler allowing easy access to Your Google Drive storage.
REQUIREMENTS
AmigaOS 3.x, 68020 28MHz, 8M fast RAM, with Internet connection. The
handler has been tested on OS3.1, and OS3.9. It may also work on AROS
Vision, and on MorphOS too. However, it has not been fully tested yet
on these platforms. (MorphOS will get a native version separately.)
LIMITATIONS
Without licence key, the handler acts as a read only volume, and document
exporting is disabled. To obtain the licence key, please contact me using
my email address. Once licence obtained, full access to all my upcoming
handlers is enabled. (Dropbox and Google Cloud Print are planned as well)
The cost of the license is 10 EUR.
INSTALLATION
Since there is no installer yet, You need to follow these steps:
1. Copy the entire 'Google' folder to your Devs: from the archive.
2. Visit the following site with a modern browser: https://goo.gl/1K3xoq
and copy the given client code into Devs:Google/_client_code
(Please note: Every time when You ask new client code, You must delete
Devs:Google/_access_token and Devs:Google/_refresh_token files if they
are exist!)
3. Add the following lines to Your user-startup:
;BEGIN Google
Assign SSLROOT: Devs:Google/.sslroot
Mount GOOGLE: from Devs:Google/google.mountlist
;END Google
(If somehow You already have SSLROOT: assign, skip that line)
That's all. Let's check your installation. Reboot, and open a new
CLI window. Type: list google:
If everything is fine, after a few seconds You should see the list of
files and folders of your GD root.
If You want to see GD icon on your Workbench, upload one from
Devs:Google/.data folder to Your GD root, and rename it to Disk.info.
Disk1.info is a classic icon format for OS3.1, Disk2.info is for
Peter Keunecke's icon.library, while Disk3.info is a png image for
OS3.9. In order to upload files You'll need to use a full version
of the handler, or a modern browser.
COMPONENTS
GD handler is based on libCurl (v7.37.1), and OpenSSL (0.9.8zh)
This version of openssl contains all security patches until
2015.12.03, but supports only TLS 1.0. Use this handler at Your
own risk. If You have stronger CPU (68040/68060/Apollo FPGA),
You can try the handler built with the latest, full featured,
but slower openssl. (v1.0.2e) Just rename google-drive-handler_102e
to google-drive-handler in Your Devs:Google folder.
You can check the components, and the licence status with this
command: list google:@about
The SSL connection and data transmission is a relatively slow on
68k based machines. GD handler worked on my boosted ACA1221 with
68020 28MHz, but it wasn't too fast. For the fluent operating a
68030 is strongly recommended.
TECHNICAL RESTRICTIONS
- GD does not show the file size of the document type files. The zero
file size may cause problems, thus the handler showing a huge file size
for exportable documents. The real size is determined only at the export
time. File managers without EOF support are unable to handle it. Dopus
can't handle EOF, and its default I/O buffer size is too small for
networking. I recommend FileMaster, or Workbench for GD. FileMaster uses
big enough (and adjustable) I/O buffer size by default, and handles EOF.
- GD does not allow modification of file contents. If You want to modify
a file, make a local copy first, and when You have finished, upload it
to your GD.
- GD expects the exact file size for every upload. If You creating a new
file, it is empty. Due to this, if You uploading something, the content
will be stored into a buffer, and the real upload will occur when the
file has been closed. The maximum size of the uploaded file is limited
by amount of free RAM.
PLANNED FEATURES
- OCR (automatic text document export from image, during upload)
- Shared file support
- icon ghosting
- thumbnails as icons for NG systems
- 64 bit actions for NG systems
- change detection (if You operate with GD on other machine too)
- MOS, AROS x86, OS4 port (I have no OS4 capable machine yet)
VERSION
This handler is still in an early stage of development, far from the
mature state. It may contain bugs. Please consider this release as a
public beta. Any feedback is welcomed.
Thanks to:
- BSzili,
- Viktor Soponyai alias dh1 from Amiga Mania Magazin,
- PMonster,
- Sir_Lucas
|