The All-in-One Guide to OXZ Packaging and Distribution
Moderators: winston, another_commander
- Reval
- ---- E L I T E ----
- Posts: 402
- Joined: Thu Oct 29, 2020 3:14 am
- Location: At home in the Xexedi Cluster, driving an FE Asp II, Laenina's Flux.
Re: The All-in-One Guide to OXZ Packaging and Distribution
Is it OK to keep the OXP's requires.plist in with the manifest.plist when you zip it up, or will it need to be deleted for the Manager?
Dor 'call me Grocer' Reval (a Xexedian Laver) was always considered a little backward.
-
- Quite Grand Sub-Admiral
- Posts: 6671
- Joined: Wed Feb 28, 2007 7:54 am
Re: The All-in-One Guide to OXZ Packaging and Distribution
You need to keep it in the zip file.
- Reval
- ---- E L I T E ----
- Posts: 402
- Joined: Thu Oct 29, 2020 3:14 am
- Location: At home in the Xexedi Cluster, driving an FE Asp II, Laenina's Flux.
Re: The All-in-One Guide to OXZ Packaging and Distribution
Ok, thanks. And is it advisable to have the Wiki account login (for the info link) _before_ uploading to the Manager?
Also, is a ReadMe file expected, or does the manifest summary text suffice (and how long can it be?)?
Edit: the summary, that is.
Also, is a ReadMe file expected, or does the manifest summary text suffice (and how long can it be?)?
Edit: the summary, that is.
Dor 'call me Grocer' Reval (a Xexedian Laver) was always considered a little backward.
-
- Quite Grand Sub-Admiral
- Posts: 6671
- Joined: Wed Feb 28, 2007 7:54 am
Re: The All-in-One Guide to OXZ Packaging and Distribution
I think it is best to have the wiki page prepared before you do the OXZ Manager part, if you do intend to have a wiki page, that is.
A ReadMe file is nice to have, but since the oxz is a zipped file, nobody is expected to read it unless they extract the oxz in their AddOns folder using the Manager's extract option. And even then, I bet very few will read it. So, up to you really if you want to include one or not. In any case, the description text should be as informative as possible in as little space as possible. Summaries longer than around 300 characters will spill over the options text of the Manager screen (that's actually a bug, we should be able to handle extremely long descriptions somehow).
A ReadMe file is nice to have, but since the oxz is a zipped file, nobody is expected to read it unless they extract the oxz in their AddOns folder using the Manager's extract option. And even then, I bet very few will read it. So, up to you really if you want to include one or not. In any case, the description text should be as informative as possible in as little space as possible. Summaries longer than around 300 characters will spill over the options text of the Manager screen (that's actually a bug, we should be able to handle extremely long descriptions somehow).
- Reval
- ---- E L I T E ----
- Posts: 402
- Joined: Thu Oct 29, 2020 3:14 am
- Location: At home in the Xexedi Cluster, driving an FE Asp II, Laenina's Flux.
Re: The All-in-One Guide to OXZ Packaging and Distribution
Ok, got it - thanks. But no hyperbole, though, right? We're not _selling_ these OXPs?
Dor 'call me Grocer' Reval (a Xexedian Laver) was always considered a little backward.
- montana05
- ---- E L I T E ----
- Posts: 1166
- Joined: Mon May 30, 2016 3:54 am
- Location: lurking in The Devils Triangle (G1)
Re: The All-in-One Guide to OXZ Packaging and Distribution
No, Oolite is non-commercial so no selling CC BY-NC-SA 4.0 is already implying that. While I do agree with a_c a quick readme.txt with the source is always nice to have. A quick description, license and change history would do.
Btw for the expansion manager you will need an access code, aka user key.
Scars remind us where we've been. They don't have to dictate where we're going.
- Reval
- ---- E L I T E ----
- Posts: 402
- Joined: Thu Oct 29, 2020 3:14 am
- Location: At home in the Xexedi Cluster, driving an FE Asp II, Laenina's Flux.
Re: The All-in-One Guide to OXZ Packaging and Distribution
That's the login credentials for the OXZ manager, right? If so, I got that today.
Edit: Just waiting for the Wiki login now...
Edit: Just waiting for the Wiki login now...
Dor 'call me Grocer' Reval (a Xexedian Laver) was always considered a little backward.
- stranger
- ---- E L I T E ----
- Posts: 351
- Joined: Thu Apr 05, 2018 5:31 am
- Location: Vladivostok, Russia
Re: The All-in-One Guide to OXZ Packaging and Distribution
I need some hints.
Trying to upload updated MoonsTexturePack.oxz today and get this warning:
Upload warning
The file you uploaded seems to be empty. This might be due to a typo in the filename. Please check whether you really want to upload this file.
Moreover, trying to visit page wit already uploaded files I get this message:
A database query error has occurred. This may indicate a bug in the software.[7b246d53f2c3833a08ac1970] 2020-11-26 01:19:58: Fatal exception of type "Wikimedia\Rdbms\DBQueryError"
I have no idea what is wrong with this latest pack. Assembling it and preparing in exactly same way as previous version - just replace texture files and update info.plist and manifest.plist.
Trying to upload updated MoonsTexturePack.oxz today and get this warning:
Upload warning
The file you uploaded seems to be empty. This might be due to a typo in the filename. Please check whether you really want to upload this file.
Moreover, trying to visit page wit already uploaded files I get this message:
A database query error has occurred. This may indicate a bug in the software.[7b246d53f2c3833a08ac1970] 2020-11-26 01:19:58: Fatal exception of type "Wikimedia\Rdbms\DBQueryError"
I have no idea what is wrong with this latest pack. Assembling it and preparing in exactly same way as previous version - just replace texture files and update info.plist and manifest.plist.
- Cody
- Sharp Shooter Spam Assassin
- Posts: 16081
- Joined: Sat Jul 04, 2009 9:31 pm
- Location: The Lizard's Claw
- Contact:
Re: The All-in-One Guide to OXZ Packaging and Distribution
See here.
I would advise stilts for the quagmires, and camels for the snowy hills
And any survivors, their debts I will certainly pay. There's always a way!
And any survivors, their debts I will certainly pay. There's always a way!
- stranger
- ---- E L I T E ----
- Posts: 351
- Joined: Thu Apr 05, 2018 5:31 am
- Location: Vladivostok, Russia
Re: The All-in-One Guide to OXZ Packaging and Distribution
Thank you, Cody. Already find it. Seems it is not fault on my side.
Well, let's wait for fixing issue.
Well, let's wait for fixing issue.
- Cholmondely
- Archivist
- Posts: 5345
- Joined: Tue Jul 07, 2020 11:00 am
- Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
- Contact:
Re: The All-in-One Guide to OXZ Packaging and Distribution
Problems with the dreaded AppleMac regarding zipping an oxz:
AppleMac comes with "Archive Utility" (Version 10.15 (128.2.1)) which happily unzips oxz's.
But when I try the reverse, bung it in the ManagedAddOns folder and restart Oolite I get "~~~~~.oxz does not have a valid manifest.plist and could not be loaded"
This even happens when I unzip and then immediately re-zip what I unzipped!
What am I doing wrong?
I can work around it by bunging the failed oxz in the AddOns folder, but I want a working oxz!
AppleMac comes with "Archive Utility" (Version 10.15 (128.2.1)) which happily unzips oxz's.
But when I try the reverse, bung it in the ManagedAddOns folder and restart Oolite I get "~~~~~.oxz does not have a valid manifest.plist and could not be loaded"
This even happens when I unzip and then immediately re-zip what I unzipped!
What am I doing wrong?
I can work around it by bunging the failed oxz in the AddOns folder, but I want a working oxz!
Comments wanted:
•Missing OXPs? What do you think is missing?
•Lore: The economics of ship building How many built for Aronar?
•Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
•Missing OXPs? What do you think is missing?
•Lore: The economics of ship building How many built for Aronar?
•Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
- stranger
- ---- E L I T E ----
- Posts: 351
- Joined: Thu Apr 05, 2018 5:31 am
- Location: Vladivostok, Russia
Re: The All-in-One Guide to OXZ Packaging and Distribution
Go INTO unzipped OXZ folder, select ALL content of unzipped OXZ folder and zip ONLY this selected content, NOT root folder! After zipping relocate archive from root folder, rename it and change extension from .zip to .oxz
- Cholmondely
- Archivist
- Posts: 5345
- Joined: Tue Jul 07, 2020 11:00 am
- Location: The Delightful Domains of His Most Britannic Majesty (industrial? agricultural? mainly anything?)
- Contact:
Re: The All-in-One Guide to OXZ Packaging and Distribution
I tried that too: I ended up with a zillion and one zipped files rather than just the one!
Are you saying that I bung the zipped file collection into a new folder and title that as .oxz?
Edited to add: Stranger's suggestion (further down) works for my AppleMac.
Last edited by Cholmondely on Thu Aug 26, 2021 12:50 pm, edited 1 time in total.
Comments wanted:
•Missing OXPs? What do you think is missing?
•Lore: The economics of ship building How many built for Aronar?
•Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
•Missing OXPs? What do you think is missing?
•Lore: The economics of ship building How many built for Aronar?
•Lore: The Space Traders Flight Training Manual: Cowell & MgRath Do you agree with Redspear?
- montana05
- ---- E L I T E ----
- Posts: 1166
- Joined: Mon May 30, 2016 3:54 am
- Location: lurking in The Devils Triangle (G1)
Re: The All-in-One Guide to OXZ Packaging and Distribution
A workaround sometimes helps is to add the manifest and (probably) the redme as well is copying the file(s) manually in the zip before renaming it to an oxz.Cholmondely wrote: ↑Sun Jul 11, 2021 1:20 pmI tried that too: I ended up with a zillion and one zipped files rather than just the one!
Are you saying that I bung the zipped file collection into a new folder and title that as .oxz?
Scars remind us where we've been. They don't have to dictate where we're going.
- stranger
- ---- E L I T E ----
- Posts: 351
- Joined: Thu Apr 05, 2018 5:31 am
- Location: Vladivostok, Russia
Re: The All-in-One Guide to OXZ Packaging and Distribution
Well. DarkRay OXZ for example.
Unzipping (extracting) this folder will create new folder DarkRay (usual folder without any extensions).
It contains three files and one folder:
info.plist
manifest.plist
readme.txt
Textures
Go into DarkRay folder and select all these items, not DarkRay folder per se!
Right click onto these 4 items will show contextual menu with option Archive 4 items. Select this option.
Now you have new element in DarkRay folder:
Archive.zip
info.plist
manifest.plist
readme.txt
Textures
Relocate this new created Archive.zip onto Desktop and change name from Archive.zip to DarkRay.oxz
That's all. It is ready to upload.
Unzipping (extracting) this folder will create new folder DarkRay (usual folder without any extensions).
It contains three files and one folder:
info.plist
manifest.plist
readme.txt
Textures
Go into DarkRay folder and select all these items, not DarkRay folder per se!
Right click onto these 4 items will show contextual menu with option Archive 4 items. Select this option.
Now you have new element in DarkRay folder:
Archive.zip
info.plist
manifest.plist
readme.txt
Textures
Relocate this new created Archive.zip onto Desktop and change name from Archive.zip to DarkRay.oxz
That's all. It is ready to upload.