Download repository.example - download do código-fonte repository.example

repository.example

Outro código-fonte

1.0.0

Baixar

Tutorial e repositório de exemplo para configurar um repositório Kodi hospedado no GitHub. Para obter um exemplo de repositório criado usando este método (incluindo submódulos), consulte https://www.github.com/jurialmunkey/repository.jurialmunkey/.

BASIC - Como configurar a hospedagem nas páginas do GitHub

Para seguir este tutorial, primeiro use este repositório como modelo para um novo repositório e, em seguida, clone seu repositório recém-criado localmente. Para obter o URL de origem do gerenciador de arquivos mais simples, é recomendável nomear seu repositório recém-criado como YOUR_USERNAME_HERE.github.io .

Criando seu complemento de repositório

Primeiro, você precisará editar o arquivo addon.xml dentro da pasta /repo/repository.example com o ID do complemento escolhido, um número de versão e seu nome de usuário (ou o que você quiser) para provider , como visto na linha 2:

< addon id = " ADDON_ID_HERE " name = " REPO_NAME_HERE " version = " VERSION_NUMBER_HERE " provider-name = " YOUR_USERNAME_HERE " >

Você também precisa substituir YOUR_USERNAME_HERE , REPOSITORY_NAME_HERE e BRANCH_NAME_HERE pelo seu nome de usuário do GitHub, o nome deste repositório e o nome do branch (é recomendado usar o branch padrão, geralmente master ou main ), respectivamente, como visto nas linhas 4-8:

< dir >
    < info compressed = " false " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/BRANCH_NAME_HERE/repo/zips/addons.xmlinfo >
    < checksum >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/BRANCH_NAME_HERE/repo/zips/addons.xml.md5checksum >
    < datadir zip = " true " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/BRANCH_NAME_HERE/repo/zips/datadir >
dir >

Você também deve alterar o resumo e a descrição do seu repositório, conforme visto nas linhas 11-12:

< summary >REPO_NAME_HEREsummary >
< description >DESCRIPTION OF YOUR REPO HEREdescription >

Embora não seja obrigatório, também é recomendado substituir icon.png e fanart.jpg na pasta repository.example por arte relevante para o seu repositório ou para os complementos contidos nele. icon.png deve ter 512x512 px e fanart.jpg deve ter 1920x1080 px ou uma proporção semelhante.

Por fim, renomeie a pasta repository.example para corresponder ao ID do complemento que você escolheu anteriormente.

Adicionando complementos ao seu repositório

Para construir o repositório, primeiro coloque as pastas de origem dos complementos que você deseja que estejam contidos em seu repositório Kodi dentro deste repositório. Para facilitar a atualização dos complementos incluídos, o método recomendado para fazer isso é por meio dos submódulos Git, que são suportados por muitos clientes Git, bem como pelo terminal Git. Se você optar por não usar submódulos, precisará simplesmente copiar as pastas de origem diretamente para este repositório.

O script _repo_xml_generator.py incluído neste repositório com arquivos .zip de construção para cada complemento incluído, além de gerar os arquivos addons.xml e addons.xml.md5 necessários, para que Kodi possa inferir o conteúdo do repositório. Ele foi projetado para lidar com várias versões do Kodi (por exemplo, para servir diferentes complementos para Leia dos que são servidos para o Matrix) e repositórios únicos que servem os mesmos complementos para todas as versões do Kodi.

Mesmos complementos para todas as versões (padrão)

Coloque suas pastas de origem complementares na pasta repo deste repositório.

Diferentes complementos para diferentes versões (avançado)

Coloque suas pastas de origem complementares em uma pasta com o nome da versão do Kodi que você deseja servir, em vez de /repo . Por exemplo, /leia para um repositório focado em Leia ou /matrix para um repositório focado em Matrix. Para que seu repositório seja capaz de diferenciar quais complementos servir, você precisará adicionar uma nova seção dir ao seu addon.xml , que define quais versões devem ser servidas.

Por exemplo, para servir apenas Leia:

< dir minversion = " 18.0.0 " maxversion = " 18.9.9 " >
    < info compressed = " false " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/leia/zips/addons.xmlinfo >
    < checksum >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/leia/zips/addons.xml.md5checksum >
    < datadir zip = " true " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/leia/zips/datadir >
dir >

E para Matrix e superior:

< dir minversion = " 19.0.0 " >
    < info compressed = " false " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/matrix/zips/addons.xmlinfo >
    < checksum >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/matrix/zips/addons.xml.md5checksum >
    < datadir zip = " true " >https://raw.githubusercontent.com/YOUR_USERNAME_HERE/REPOSITORY_NAME_HERE/DEFAULT_BRANCH_NAME_HERE/matrix/zips/datadir >
dir >

Depois de adicionar suas pastas de origem, basta executar _repo_generator.py . Isso criará .zip s de todos os complementos desejados e os colocará em subpastas chamadas zips , junto com os addons.xml e addons.xml.md5 gerados. A partir da versão 3, este script pode criar distribuições para Krypton, Leia, Matrix e Nexus, bem como o "repo" genérico, que se destina a servir para qualquer versão (como para o próprio repositório ou qualquer biblioteca de versão cruzada). e dependências).

Torne seu repositório zip instalável dentro do Kodi

Copie o arquivo zip do seu repositório, localizado em REPO_FOLDER/zips/ADDON_ID_HERE/ADDON_ID_HERE-VERSION_NUMBER_HERE.zip e cole-o na pasta raiz.

Edite o link dentro de index.html para refletir o nome do arquivo do seu complemento, conforme visto na linha 1:

 < a href =" ADDON_ID_HERE-VERSION_NUMBER_HERE.zip " > ADDON_ID_HERE-VERSION_NUMBER_HERE.zip  a >

Depois de confirmar e enviar essas alterações para o seu repositório, vá para a seção "Configurações" deste repositório no GitHub. Na primeira caixa, denominada “Nome do repositório”, altere o nome do seu repositório. Geralmente, os repositórios do GitHub Pages são nomeados YOUR_USERNAME_HERE.github.io , mas pode ser o que você quiser. Em seguida, role para baixo até a seção "Páginas do GitHub", escolha o branch padrão (ou o que você escolheu ao modificar seu addon.xml ) como fonte e clique em "Salvar".

Depois disso, você deve estar pronto!

Se você nomeou este repositório YOUR_USERNAME_HERE.github.io (conforme recomendado), a fonte do seu gerenciador de arquivos será:

https://YOUR_USERNAME_HERE.github.io/

Se você deu outro nome, será:

https://YOUR_USERNAME_HERE.github.io/REPOSITORY_NAME_HERE/

AVANÇADO - Como configurar a hospedagem sem GitHub Pages

Se você deseja hospedar seu repositório Kodi em um host diferente além do GitHub Pages, basta baixar este repositório como um .zip e descompactá-lo, em vez de usá-lo como modelo. Continue seguindo o restante do procedimento de configuração, exceto para a configuração das páginas do GitHub. As únicas diferenças estarão no seu arquivo addon.xml , pois ele precisará fazer referência ao seu host, em vez do GitHub:

< dir >
    < info compressed = " false " >https://YOUR_HOST_URL_HERE/repo/zips/addons.xmlinfo >
    < checksum >https://YOUR_HOST_URL_HERE/repo/zips/addons.xml.md5checksum >
    < datadir zip = " true " >https://YOUR_HOST_URL_HERE/repo/zips/datadir >
dir >

E carregue o conteúdo deste repositório para o seu host. É muito importante que YOUR_HOST_URL_HERE seja a URL da pasta raiz deste repositório.

Depois de fazer isso, a fonte do seu gerenciador de arquivos será:

https://YOUR_HOST_URL_HERE/

Expandir

Informações adicionais